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Android 是 当今 应 用 最 为 广泛 的 智能 手机 平台 ,具有 丰富 的 软件 资源 。 
Android 软件 开发 具有 一 定 的 难度 ,一 般 需 要 开发 者 具备 一 定 的 软件 开发 
知识 和 经 验 ,App Inventor 2 的 出 现 将 非 程序 人 员 编写 Android 应 用 软件 
的 愿望 变 成 了 现实 。App Inventor 2 创造 的 拼图 开发 方式 简化 了 复杂 的 程 
序 编码 过 程 , 极 大 地 提升 了 学 习 者 对 软件 编程 的 兴趣 ,并 为 学 习 之 路 创造 了 
一 个 轻松 的 开始 。 

书 中 所 涉及 的 内 容 包 括 App Inventor 2 的 开发 环境 搭建 ,程序 设计 基 
础 、 用 户 界面 游戏 、 多 媒体 、 数 据 存 储 、 社 交 、 网 络 通 信和 地 图 应 用 开发 等 方 
面 , 较 全 面 地 覆盖 了 Android 程序 开发 所 涉及 的 内 容 。 

全 书 内 容 简介 如 下 。 

第 1 章 介绍 App Inventor 2 的 起 源 和 优势 ,展示 了 利用 App Inventor 
开发 的 一 些 作 品 , 并 对 互联 网 上 的 App Inventor 2 学 习 资 源 进 行 了 简单 的 
介绍 。 

第 2 章 介绍 App Inventor 2 的 开发 环境 和 账号 注册 方法 ,并 简单 说 明 
了 如 何 使 用 模拟 器 和 手机 进行 程序 调试 。 

第 3 章 介绍 开发 App Inventor 2 应 用 程序 的 基础 知识 和 基本 方法 ,说 
明了 App Inventor 2 的 界面 编辑 器 和 模块 编辑 器 的 作用 及 其 使 用 方法 。 

第 4 章 详细 介绍 App Inventor 2 程序 开发 的 基础 内 容 , 包 括 条 件 判 断 、 
循环 、 列 表 和 函数 。 

第 5 章 介绍 利用 App Inventor 2 进行 界面 设计 和 开发 的 方法 ,重点 介 
绍 了 常见 控件 的 使 用 方法 ,并 对 屏幕 的 布局 方式 进行 了 讲解 。 

第 6 章 介绍 如 何 使 用 App Inventor 2 开发 游戏 ,详细 讲解 了 画布 .精灵 
和 球体 控件 的 使 用 ,并 介绍 了 碰撞 检测 的 原理 。 

第 7 章 介绍 App Inventor 2 的 多 媒体 控件 和 社交 控件 的 使 用 方法 。 

第 8 章 介绍 App Inventor 2 数据 存储 机 制 , 主 要 讲解 了 本 地 数据 库 、 网 
络 数据 库 和 数据 融合 表 的 使 用 方法 ,说 明了 如 何 使 用 这 些 控件 进行 数据 存 
储 、 访 问 和 共享 。 

第 9 章 介 绍 利用 App Inventor 2 进行 网 络 通信 和 地 图 应 用 的 开发 方 
法 ,讲解 了 如 何 使 用 位 置 传感器 和 谷歌 地 图 ,以 及 如 何 使 用 蓝牙 和 Web d 
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件 进 行 网 络 通信 。 

本 书 主编 是 王 向 辉 老师 , 副 主编 是 张 国 印 和 沈 洁 老 师 。 其 中 , 王 向 辉 编 写 第 1 一 3 章 ， 
张 国 印 编写 第 4 一 5 章 , 沈 洁 编写 第 6 一 9 章 。 参 与 本 书 编写 和 核对 工作 的 还 有 和 孙 字 彤 、 杨 
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本 书 得 到 谷歌 2014 年 “Android/App Inventor 教材 出 版 计划 ”的 资助 。 

App Inventor 是 一 种 新 兴 的 开发 模式 ,很 多 方面 还 在 不 断 完 善 和 变化 。 由 于 能 力 和 
水 平 所 限 , 虽 然 竟 尽 全 力 ,但 本 书 仍 然 难 免 存 在 疏漏 ,希望 各 位 专家 、 教 师 和 学 生 能 毫 不 保 
留 地 提出 所 发 现 的 问题 ,与 编者 共同 讨论 与 交流 ,编者 的 邮箱 为 wangxianghui@live. cn, 

App Inventor 2 Ji Y Android 程序 开发 中 复杂 的 编程 细节 ,因此 可 供 没 有 程序 基 
础 的 低 年 级 学 生 和 非 计算 机 专业 学 生 学 习 使 用 ,可 以 在 大 学 一 年 级 和 二 年 级 开设 这 门 
课程 。 

所 有 示例 代码 和 教学 资源 (教学 大 岗 、 教 学 PPT、 习 题 答案 等 ) 均 在 哈尔滨 工程 大 学 
的 Android 资料 网 站 中 (http://android. hrbeu. edu. cn) 提 供 下 载 。 
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Android 与 App Inventor 2 


App Inventor 2 3€ — 4- Jk + I] 3t , TH X, 8 Android 程序 开发 环境 , 它 将 枯燥 的 代码 
变 成 一 块 一 块 的 拼图 ,使 Android 软件 开发 变 得 简单 有 趣 , 使 不 懂 编 程 的 用 户 也 可 以 开发 出 
属于 自己 的 Android 应 用 程序 。 通 过 本 章 的 学 习 , 读 者 将 了 解 Android 系统 的 特点 和 发 展 趋 
势 , 掌 握 App Inventor 2 的 起 源 和 优势 ,了 解 互联 网 上 一 些 App Inventor 2 的 学 习 资 源 。 

本 章 学 习 目标 

* 了 解 Android 系统 的 起 源 和 发 展 趋势 

。 掌握 App Inventor 2 的 优势 

* 了 解 App Inventor 2 的 学 习 资 源 


11 Android Bill 
Android 是 Google 发 布 的 基于 Linux 平台 的 开源 手机 操作 系统 。Android 一 词 的 本 


义 是 “机 器 人 ”, 国 内 多 称 为 " 安 卓 "”。Android 最 初 应 用 在 智能 手机 和 平板 电脑 上 ,是 第 一 
个 完整 .开放 、 免 费 的 手机 操作 系统 ,界面 如 图 1. 1 所 示 


图 1.1 Android 界面 
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Tih + DÆ (Andy Rubin) F 2003 年 创建 了 Android. JF ZH € f Android 团队 ,于 
2005 年 被 Google 收购 。2007 年 11 月 5 日 ,Google 公司 正式 向 外 界 展 示 了 这 款 名 为 
Android 的 操作 系统 。 

Android 是 当今 世界 上 应 用 最 广泛 的 智能 手机 平台 。 截 至 2012 4£ 10 月 ,Android 应 
用 软件 已 达到 了 大 约 70 万 个 ,在 Google Play 的 软件 下 载 量 达到 了 250 亿 次 。2012 年 9 
月 的 统计 数据 表明 ,每 天 的 Android 设备 激活 数量 已 经 超过 了 130 万 台 ,激活 的 设备 总 量 
超过 4. 8 亿 。Android 在 全 球 智 能 手机 操作 系统 市 场所 占 的 份额 为 76 96 ,在 中 国 市 场 的 
占有 率 高 达 90%。 

Android 应 用 得 如 此 广泛 ,与 其 自身 的 特点 是 分 不 开 的 。 首 先 , Android 是 一 款 开源 
的 手机 系统 ,开源 有 效 地 缩短 了 开发 周期 ,降低 了 开发 成 本 。 用 户 可 以 免费 下 载 Android 
源 代码 ,并 在 原 系统 的 基础 上 进行 二 次 开发 ,创造 具有 个 性 化 的 Android 系统 。Android 
为 各 种 应 用 程序 提供 平等 的 性 能 支持 ,能 够 满足 用 户 对 不 同 应 用 的 需求 ,用 户 可 以 下 载 自 
己 喜 欢 的 软件 到 手机 上 ,也 可 更 改 手机 的 界面 或 图 片 的 浏览 方式 ,使 自己 的 手机 与 众 不 
同 。 借 助 谷歌 在 互联 网 运营 方面 的 优势 ,谷歌 地 图 、 邮 件 和 搜索 等 服务 直接 内 置 在 
Android 系统 中 ,作为 用 户 与 互联 网 之 间 的 重要 纽带 ,增强 了 手机 的 实用 功能 。 

Android 系统 最 初 只 是 为 智能 手机 所 设计 ,但 随 着 应 用 领域 的 不 断 拓展 , Android 系 
统 逐 渐 广泛 应 用 在 平板 电脑 ,电视 手表、 眼镜、 冰箱 、 耳 机 和 跑步 机 等 设备 中 ,使 我 们 的 生 
活 变 得 越 来 越 智能 化 。 

如 图 1.2 所 示 ,“ 谷 歌 眼 镜 ” 是 谷歌 在 2012 年 4 月 发 布 的 一 款 “ 扩 展现 实 ” 眼 镜 产品 ， 
可 以 语音 拍照 ,视频 通话 和 辨 明 方向 ,也 可 以 访问 互联 网 信息 ,还 可 以 处 理 文字 信息 和 电 
子 邮 件 。 眼 镜 的 右 眼 镜片 上 安装 了 一 个 微型 投影 仪 和 一 个 摄像 头 ,投影 仪 用 以 显示 数据 ， 
摄像 头 用 来 拍摄 视频 和 照片 ,再 通过 传感器 进行 存储 和 传输 ,而 操控 模式 可 以 是 语音 台 
触 控 。 


图 1.2 谷歌 眼镜 


如 图 1. 3 所 示 ,基于 Android 系统 的 im Watch 智能 手表 可 以 显示 时 间 和 天 气 预 报 ， 
还 可 以 显示 短信 息 和 联系 人 等 ,并 可 与 其 他 Android 系统 手机 联接 。 

如 图 1.4 所 示 ,海尔 LD50H9000 智能 电视 使 用 双核 CPU 和 双核 GPU ,屏幕 尺寸 为 
50 二 ,分辩 率 为 3840X2160 ,运行 最 新 的 Android 4. 0 系统 。 

如 图 1.5 所 示 ,三 星 Android 冰箱 是 一 台 有 内 置 应 用 软件 的 冰箱 ,功能 包括 显示 照 
片 播放 音乐 和 给 家 人 留 便条 等 ,三 星 Android 冰箱 还 有 一 个 专门 用 来 除 霜 以 及 改变 温度 
的 应 用 软件 。 


图 1.5 =E Android 冰箱 


如 图 1.6 所 示 ,Admiral Touch 耳机 同样 是 基于 Android 系统 ,配备 了 一 块 2.4 英寸 
的 彩色 触摸屏 ,用户 可 以 用 它 玩 游戏 和 看 电影 ,这 款 耳 机 支持 2. 4G 和 蓝牙 通信 ,具备 7.1 


虚拟 环绕 音效 。 
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1.6 Admiral Touch 耳机 
如 图 1.7 所 示 ,ProForm Trailrunner 4. 0 是 一 款 内 置 Android 系统 的 跑步 机 , 配 有 
10 英寸 的 显示 屏 。 该 跑步 机 除了 配 有 传统 的 心跳 监测 .运动 课程 计划 热量 消耗 统计 等 
功能 之 外 ,还 支持 WiFi 上 网 ,可 以 在 跑步 的 时 候 查 看 新 闻 收发 邮件 或 欣赏 影片 。 


1.7 ProForm Trailrunner 4. 0 跑步 机 


1.2 App Inventor 2 起 源 


App Inventor 的 研发 目标 是 “使 人 们 在 移动 通信 的 世界 里 成 为 创造 者 ,而 不 仅仅 是 消 
费 者 ”。 

App Inventor 在 很 多 方面 借鉴 了 麻 省 理工 大 学 的 可 视 化 教学 项 目 StarLogo TNG 
CThe Next Generation) 和 Scratch 的 研究 成 果 。StarLogo TNG 和 Scratch 在 很 多 方面 对 
App Inventor 产生 了 重要 的 影响 ,比如 都 采用 拖 忠 的 编辑 方式 、 模 块 化 的 编程 语言 , 且 
App Inventor 和 Scratch 一 样 ,都 致力 于 为 初学 者 创造 更 愉快 和 更 简易 的 编程 体验 。 
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StarLogo TNG 是 一 种 基于 主体 的 仿真 语言 ,由 麻 省 理工 媒体 实验 室 和 教师 教学 计 
划 共 同 研发 ,其 设计 的 目的 主要 针对 计算 机 教育 ,可 以 用 来 模拟 分 散 式 控制 系统 的 行为 。 
StarLogo TNG 能 够 利用 开放 式 图 形 库 提供 3D 视野 ,并 运用 模块 图 形 语言 来 增强 易 用 性 
和 易学 性 ,如 图 1.8 所 示 。 


E Santogo TNG: start ogeBiocks "My feit program? =a 


ER 


1.8 StarLogo TNG 


Scratch 是 麻 省 理工 媒体 实验 室 开发 的 一 款 面 向 儿童 的 简易 编程 工具 , 旨 在 通过 游戏 
式 的 方式 激发 深层 次 的 学 习 。 如 图 1.9 所 示 , 用 户 可 以 利用 Scratch 创建 互动 动画 、 故 事 
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图 1.9 Scratch 
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或 游戏 ,并 可 通过 网 络 与 其 他 开发 者 分 享 自 己 的 创造 成 果 。 麻 省 理工 学 院 的 Scratch Bl 
队 重 视 软件 的 易学 性 ,创建 和 调试 Scratch 程序 都 非常 简易 ,最早 的 版 本 由 “终生 幼儿 园 
HIBA” (Lifelong Kindergarten Group) f£ 2006 年 发 布 。 

App Inventor 曾 是 谷歌 实验 室 的 一 个 子 计 划 , 于 2010 年 7 月 推出 ,是 一 款 所 见 即 所 
得 的 Android 应 用 程序 创建 器 , 它 允 许 没 有 编程 知识 的 用 户 通 过 拖 电 特定 的 程序 模块 来 
创建 Android 应 用 。2011 年 8 月 ,谷歌 将 该 项 目的 源 代码 对 外 开放 ,并 于 2012 年 1 月 将 


省 理工 学 院 的 Hal Abelson 教授 领导 开发 ,于 2012 4E 3 月 向 互联 网 用 户 开放 使 用 ,并 更 
名 为 MIT App Inventor, 网 站 首页 如 图 1. 10 所 示 。 


Welcome to MIT App Inventor 
U test J 


App Inventor can now connect wirelessly to phones and tablets! 


Important Notices 
Connecting Wirelessly? Upgrade Companion App to 2.05 
Using Android 4.2.2 and a USB Cable? Upgrade adb 


Explore 


Educator Resources Information & Tutorials Create Mobile Apps 


1.10 MIT App Inventor 网 站 首页 


2013 4E, MIT 发 布 App Inventor 的 新 版 本 App Inventor 2( 简 称 AI2) ,网 站 首页 如 
图 1.11 所 示 。 原 有 版 本 更 名 为 App Inventor Classic。 原 有 版 本 虽然 目前 仍 可 以 使 用 ， 
但 在 不 久 将 会 被 关 停 。 


Bm Hom。 Blog” Support + 


Æ 1.11 MIT App Inventor 2 网 站 首页 
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AI2 的 开发 将 完全 在 网 页 中 进行 ,不 再 依赖 Java 虚拟 机 ,而 且 在 开发 过 程 中 更 加 高 
效 tE., App Inventor Classic 的 代码 存档 格式 为 zip 文件 ,而 AI2 的 代码 存档 格式 为 
aia 文件 ,这 两 个 版 本 的 代码 存档 互 不 兼容 ,因此 App Inventor Classic 的 代码 存档 无 法 直 
接 在 AI2 中 使 用 。 
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目前 比较 流行 的 Android 开发 方式 是 使 用 Eclipse 编写 Java 代码 ,Eclipse 集成 开发 
环境 如 图 1. 12 所 示 。 使 用 代码 进行 程序 开发 是 目前 较为 成 熟 且 普遍 的 方法 ,这 种 开发 方 
式 对 开发 人 员 的 开发 知识 和 经 验 具 有 一 定 的 要 求 , 对 于 刚刚 接触 程序 开发 或 者 没有 程序 
开发 经 验 的 用 户 来 说 ,使 用 代码 开发 是 一 件 较为 困难 的 事情 。 


in-m- BB SLE 5-0-Q-wg- *o$4- Pv m [ss ooms $ Debog 


T HeloAndroidacinityjava 31 "S 2B) 
B package ev-hroeu reT1osndrcldz 


(E Probame | G Javadoc [E Declraion I Coreole 7 AE METH 
android 


- Ji. 
D P eduhrbeuHelcAndroid HolcAndroidActvityjava - HeloAndroid/sre Updating indeve Exe 


图 1.12 Eclipse 集成 开发 环境 


相 比 之 下 ,App Inventor 2 为 用 户 提 供 了 更 为 便捷 的 开发 环境 和 方法 ,具有 操作 简 
单 、 可 视 化 .模块 化 事件 置顶 、 正 确 性 高 和 便于 调试 等 优点 。 


1. 操作 简单 


使 用 AI2 无 须 具备 编程 知识 ,也 不 需要 记忆 和 编写 代码 ,程序 的 组 件 和 功能 都 存储 
在 模块 编辑 库 中 ,如 图 1. 13 所 示 ,在 创建 程序 时 只 需 将 其 拖 忠 到 编辑 区 域 进行 组 合 即 可 ， 
用 户 不 需要 记忆 如 何 输入 指令 或 参考 任何 编程 设计 手册 。 


2. 可 视 化 和 模块 化 


在 AI2 中 ,不 仅 用 户 界面 开发 是 可 视 化 和 模块 化 的 ,程序 逻辑 的 开发 也 是 如 此 。 如 
图 1. 14 所 示 ,模块 被 分 为 不 同 的 类 别 ,并 且 标 记 成 不 同 的 颜色 ,执行 不 同 的 动作 。 在 设置 
每 个 组 件 的 行为 时 犹如 玩乐 高 积木 ,逻辑 关系 一 目 了 然 。 
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图 1.13 界面 编辑 器 


3. 事件 处 理 器 


在 传统 的 编辑 语言 中 ,对 程序 最 贴切 的 比喻 是 “一 个 程序 就 像 一 个 处 方 ,一 个 说 明 
书 ”。 然 而 , 随 着 图 形 用 户 界面 的 出 现 , 程 序 不 再 像 处 方 一 样 了 ,而 变 成 了 “事件 处 理 器 ”， 
正如 图 1.15 所 示 的 那样 , 当 按 钮 1(Button1) 被 单 击 时 ,音频 1(Sound1) 将 被 播放 ,这 便 是 
正确 的 事件 处 理 器 概念 模型 。 


when .Click 


when .Click 


do call 
£m 


1.14 模块 化 编辑 语言 图 1.15 事件 置顶 


对 于 AI2 来 说 ,一 个 应 用 程序 便 是 一 套 事件 处 理 器 。 当 用 户 想 要 设计 一 个 按钮 被 单 
击 后 的 效果 时 ,只 需 拖 忠 出 按钮 的 单 击 事件 模块 ,并 把 单 击 后 要 发 生 的 行为 模块 放置 在 按 
钮 单 击 事件 模块 中 就 可 以 了 。 在 设计 应 用 软件 的 过 程 中 ,模块 的 每 个 功能 行为 都 预先 设 
计 好 ,并 摆 放 在 开发 环境 中 供用 户 使 用 ,这 样 大 大 简化 了 程序 开发 工作 ,也 使 整个 编程 过 
程 显得 分 外 清晰 。 


4. 正确 性 高 且 便于 调试 


在 代码 式 编程 过 程 中 ,出 现 错误 后 信息 比较 隐秘 ,无 法 简单 地 遏制 错误 的 发 生 。 而 
ATZ 的 模块 编辑 语言 可 以 从 一 开始 就 限制 编程 的 出 错 几率 。 例 如 ,如 果 选 择 了 一 种 参 
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数 模块 槽 , 便 无 法 将 其 他 类 型 的 参数 模块 与 其 拼接 ,这 样 便 降 低 了 参数 设置 错误 的 几 
R., App Inventor 允许 相 匹 配 的 模块 进行 拼接 ,这 个 特点 在 一 定 程度 上 保证 了 编程 的 
正确 性 。 

如 果 编 程 过 程 中 出 现 了 错误 ,可 以 将 错误 的 组 件 直接 拖 进 AI2 的 回收 站 进行 删 
除 ,这 比 起 代码 开发 方式 对 错误 的 修补 要 方便 简捷 得 多 。 在 应 用 程序 的 开发 过 程 中 ， 
用 户 可 以 随时 在 自己 的 Android 设备 上 或 模拟 器 上 进行 调试 ,对 发 现 的 错误 可 以 随时 
进行 修改 。 


14 应 用 作品 展示 


本 节 介 绍 使 用 App Inventor 制作 出 来 的 手机 软件 作品 ,以 便 使 读者 能 够 直观 地 了 解 
App Inventor 和 AI2 的 开发 能 力 。 

如 图 1. 16 所 示 是 一 款 增 扩 实 境 的 国际 象棋 游戏 。 玩 家 用 手机 选择 自己 的 团队 和 开 
棋 的 位 置 ,利用 室外 的 开阔 地 作为 棋盘 ,然后 他 们 充当 棋子 来 回 移动 。 游 戏 通过 GPS 来 
记录 每 个 玩家 的 移动 轨迹 ,并 在 手机 屏幕 上 展示 玩家 在 虚拟 棋盘 上 的 位 置 。 

美国 海军 陆 战 队 上 士 Chris Mstzger 利用 App Inventor 开发 了 一 款 应 用 软件 ,可 以 
帮助 海军 陆 战 队 士兵 摧毁 在 战场 上 发 现 的 炸药 ,如 图 1. 17 所 示 。 


图 1.16 增 扩 实 境 国际 象棋 游戏 界面 图 1.17 弹药 检查 


在 海地 ,人 道 主 义 开源 软件 项 目 利用 App Inventor 开发 了 两 款 软件 ,可 帮助 那里 的 
人 道 主 义 救援 人 员 实 地 记录 降雨 量 和 物价 的 变化 ,如 图 1. 18 所 示 。 

阿拉 巴 马 州 劳伦斯 郡 高 中 的 学 生 用 App Inventor 开发 了 一 款 物种 检查 软件 ,可 以 用 
来 记录 野猪 的 出 没 。 这 款 软 件 所 记录 的 数据 可 以 帮助 科学 家 了 解 野猪 入 侵 的 问题 ,如 
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1.18 统计 软件 图 1.19 物种 检查 软件 
Google 图 书 搜索 软件 在 进行 搜索 时 ,用 户 可 以 输入 书籍 的 全 名 或 书 名 的 关键 词 , 然 


后 根据 用 户 所 输入 的 内 容 显示 最 相关 的 书籍 信息 ,图 1. 20 展示 了 该 软件 的 运行 界面 。 


të Ri] G3 9:21 u 
——— h h 
Ellihttp://books.google.com... 内 


Web Images Videos Maps News Shopping 


Title : Harry Potter and Google books | harry 
Harty Potter the Chamber of Secrets 3 


Authors : . K. Rowing Harry Potter and the 
Chamber of Secrets 


Loud J. K. Rowling 
patty Potter | %4% 12555 Reviews 
b | Paw Prints, 2008 - 341 

- | pages 
Between the new spirit spod 
the mysterious forces that 
stone, Harry has a lot on his 
second year at Hogwarts Sc 
Wizardry. Reprint. 
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图 1.20 Google 图 书 搜索 软件 界面 


一 款 名 为 Ez School Bus Locator 的 校车 定位 软件 ,可 以 帮助 家 长 确定 校车 所 在 的 位 
置 ,并 可 以 检查 自己 的 孩子 是 否 已 经 在 校车 上 .界面 如 图 1. 21 所 示 。 

如 图 1. 22 所 示 是 一 款 名 为 Voice-Controlled Arduino 的 语音 控制 软件 ,可 以 利用 简 
单 的 语音 命令 ,通过 手机 的 蓝牙 模块 ,控制 Arduino 硬件 上 的 LED 小 灯 的 开关 。 
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图 1.21 校车 定位 软件 界面 图 1.22 语音 控制 软件 


15 App Inventor 2 学 习 资 源 


通过 前 文 的 介绍 ,相信 读者 已 经 对 AI2 有 了 一 定 的 了 解 ,下 面 介绍 一 些 AI2 的 学 习 
资源 网 站 ,这些 网 站 中 的 资源 可 以 帮助 读者 更 好 地 学 习 和 使 用 AI2 ,进而 创造 出 更 多 有 趣 
的 应 用 程序 。 


1. MIT App Inventor( http: //appinventor. mit. edu/explore/) 


美国 麻 省 理工 大 学 的 App Inventor 2 网 站 为 学 生 .教师 提供 了 大 量 的 教学 资源 。 其 
中 Get Start 为 开发 第 一 个 AI2 程序 提供 了 简单 的 指引 ;Create 可 以 直接 打开 集成 开发 环 
境 , 进 行 AI2 的 应 用 开发 ; Tutorials 为 开发 各 种 类 型 的 AI2 程序 提供 丰富 的 说 明 ; 
Library 包含 了 在 开发 过 程 中 涉及 的 各 种 资料 ,包括 文档 、 索 引 、 提 示 和 问题 解答 等 ; 
Teach 包含 了 教师 教学 过 程 中 所 需要 的 多 种 教学 辅助 资源 ;Forums 是 MIT 为 学 生 和 教 
师 提 供 的 开发 者 论坛 。 如 果 用 户 需 要 使 用 App Inventor Classic, 可 以 通过 单 击 网 页 最 下 
Ji lj" Find out what's happening with App Inventor 1” 链 接 进 入 第 一 代 的 App Inventor. 
如 图 1.23 所 示 。 


2. App Inventor TW 中 文学 习 网 (http://www. appinventor. tw/home) 


该 网 站 为 CAVE 教育 国际 与 翰 尼 斯 企业 有 限 公司 合作 架构 的 App Inventor 教育 平 
台 , 为 学 习 者 提供 优秀 的 网 络 学 习 环 境 、 中 文 说 明和 一 些小 应 用 程序 的 源 代码 ,网 站 首页 
如 图 1. 24 所 示 。 


3. appinventor. org(http: //www. appinventor. org/) 


该 网 站 由 圣 弗 朗 西 斯 科大 学 的 David Wolber 教授 创建 ,网 站 分 为 app inventor 和 
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Æ 1.24 App Inventor TW 中 文学 习 网 


Get Started 
EBR 


app inventor 2 两 部 分 ,分 别 给 出 对 应 的 书籍 和 示例 代码 ,而 且 还 有 完整 的 学 习 指导 。 该 
网 站 的 首页 如 图 1. 25 所 示 。 
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图 1.25 appinventor. org 网 站 


4. tAIR 网 站 (http://www. tair. info/) 


tAIR 是 一 个 资料 非常 丰富 的 网 站 ,如 图 1. 26 所 示 , 关 于 App Inventor 各 个 方面 的 
资料 在 这 个 网 站 上 都 找 得 到 ,包括 示例 代码 、 视 频 资料 、 相 关 书 籍 、 论 坛 和 学 习 指引 等 
内 容 。 
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Hi 1.26 tAIR 网 站 
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5. App Inventor 社区 画廊 (http://gallery. appinventor. mit. edu/ # page%3DHome) 


这 是 一 个 非常 简洁 的 网 站 ,如 图 1. 27 所 示 , 汇 集 很 多 优秀 的 App Inventor 和 App 


Inventor 2 程序 代码 ,便于 读者 浏览 和 下 载 代码 。 
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Æ 1.27 App Inventor 社区 画廊 
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AI2 开发 环境 


App Inventor 2 开发 环境 的 安装 是 开发 应 用 程序 的 第 一 步 ,也 是 深入 了 解 AI2 的 一 
个 良好 的 途径 。 通 过 本 章 的 学 习 , 读 者 可 以 快速 掌握 如 何 使 用 AI2 开发 环境 ,了 解 AI2 
界面 编辑 器 和 模块 编辑 器 ,掌握 使 用 手机 和 模拟 器 进行 程序 调试 的 方法 。 

本 章 学 习 目标 

。 掌握 AI2 开发 环境 的 安装 方法 

。 熟悉 AI2 界面 编辑 器 和 模块 编辑 器 

。 掌握 使 用 手机 和 模拟 器 进行 应 用 程序 调试 的 方法 
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AT2 提供 了 基于 网 页 的 开发 环境 ,因此 读者 需要 检查 自己 所 使 用 的 操作 系统 和 浏览 
器 是 否 支 持 AI2 开发 。AI2 所 支持 的 操作 系统 和 浏览 器 如 表 2. 1 和 表 2.2 所 示 。 笔 者 使 
用 的 操作 系统 是 64 位 版 Windows 7, 使 用 的 浏览 器 是 Google Chrome, 


表 2.1 AI2 所 支持 的 操作 系统 


操作 系统 版 本 说 明 
Macintosh Mac OS X 10. 5 或 更 高 版 本 
Windows Windows XP, Windows Vista, Windows 7 
GNU/Linux Ubuntu 8 或 更 高 版 本 ,Debian 5 或 更 高 版 本 
Android Operating System 2. 3 或 更 高 版 本 


表 2.2 AI2 所 支持 的 浏览 器 


浏览 器 名 称 版 本 说 明 
Mozilla Firefox 3.6 或 更 高 版 本 
Apple Safari 5.0 或 更 高 版 本 
Google Chrome 4.0 或 更 高 版 本 


Microsoft Internet Explorer 暂 不 支持 
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如 果 使 用 的 浏览 器 并 不 在 AI2 的 支持 范围 内 ,AI2 会 给 出 如 图 2. 1 所 示 的 提示 ,告知 
用 户 应 当 使 用 被 支持 的 几 种 浏览 器 。 


Your browser might not be 
compatible. 


To use App Inventor for Android, you must use a 
compatible browser. 
Currently the supported browsers are: 


* Google Chrome 29+ 
* Safari 5+ 
* Firefox 234 


图 2.1 浏览 器 不 支持 的 提示 


使 用 AI2 进行 Android 应 用 开发 ,大 致 要 经 过 如 图 2. 2 所 示 的 步骤 ,首先 要 注册 一 个 
Gmail 电子 邮箱 账号 ,用 来 登录 AI2; 进 入 AI2 开发 环境 ,在 界面 编辑 器 中 开发 应 用 的 界 
面部 分 ,在 模块 编辑 器 中 开发 应 用 的 逻辑 部 分 ;在 进行 应 用 的 调试 前 ,要 先 安装 AI2 的 软 
件 包 ,手机 连接 工具 aiStarter 和 Android 模拟 器 都 在 这 个 软件 包 中 ;最 后 用 户 可 以 选择 
USB, WiFi 或 模拟 器 中 的 任意 一 种 模式 进行 应 用 的 调试 。 


一 | 通过 USB 连 接 
手机 调试 


调试 Tum 
注册 Gmail 账号 一 一 | | A (Eia | 一 一 | wrie 


-二 | -= 
i i EE 
界面 编 | | | 模块 编 
p | 辑 器 | 


图 2.2 Al2 的 开发 流程 


局 动手 机 模拟 
器 调试 
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为 了 能 够 区 分 不 同 的 用 户 ,AI2 需要 使 用 Google 的 Gmail 邮箱 账号 进行 登录 。 因 此 
在 使 用 AI 之 前 , 先 要 申请 Google 的 Gmail 账号 。 

比较 快捷 的 注册 方式 是 直接 进入 谷歌 搜索 页 面 (http://www. google. com. hk) , A 
后 单 击 页 面 右 上 角 的 “登录 ”按钮 ,进入 Gmail 邮箱 登录 页 面 ,如 图 2. 3 所 示 。 

在 登录 页 面 中 ,如 果 用 户 以 前 使 用 Gmail 账号 登录 过 谷歌 ,会 出 现 如 图 2. 4 所 示 的 重 
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Google 
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GogefE FIFE 


Googe com hk SATSES: TX (HE) Engish 


广告 ”商务 。 Google 大 全 隐私 权 和 使 用 第 款 — 设置 Google com 


图 2.3 谷歌 搜索 页 面 


新 登录 页 面 , 这 时 用 户 只 要 重新 输入 密码 就 可 以 了 。 

但 如 果 用 户 没有 登录 过 , 则 会 出 现 如 图 2. 5 所 示 的 完整 登录 页 面 , 要 求 用 户 填 写 用 户 
名 和 密码 。 拥 有 谷歌 Gmail 账号 的 用 户 可 以 直接 登录 ,如 果 没 有 Gmail 账号 , 则 可 以 单 击 
下 方 的 “创建 账户 ”按钮 进入 Gmail 邮箱 注册 页 面 。 


Google Google 
一 个 帐户 ， 畅 享 Google 所 有 服务 ! 


请 再 次 输入 您 的 密码 
使 用 您 的 Google 帐户 登录 
EPE, 电子 邮件 
warnersuper@gmail com 
密码 


密码 


需要 帮助 ? 
创建 帐户 
只 需 一 个 Google 帐户 了 可 使 用 所 有 Google 产品 /服务 
使 用 其 他 帐户 登录 HMenos»H 
图 2.4 Gmail 重新 登录 页 面 图 2.5 Gmail 登录 页 面 


在 Gmail 注册 页 面 中 ,用 户 需 要 正确 填写 姓名 、 用 户 名 、 密 码 、 生 日 .手机 号 和 电子 邮 
箱 等 信息 ,进而 完成 Gmail 账号 的 注册 过 程 ,如 图 2.6 所 示 。 
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Google 
创建 您 的 Google 帐户 
您 只 需 注 册 一 个 帐户 即 可 tkz 
HR—ERPEXEE. HORS Googe 68 ass ^ Lad ** 
39smune 
Hem: ^H Gomalcom 
我 垢 使 朋 我 目前 的 电子 邮件 地 址 
Li kill 
定制 自己 专属 的 Google 设置 
ausa 
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随时 随地 使 用 攀 当 前 的 电子 邮件 地 址 


图 2.6 Gmail 注册 页 面 
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在 完成 Gmail 账号 注册 后 ,就 可 以 开始 使 用 AI2 了 。 首 先 打开 MIT App Inventor 
网 站 (http://appinventor. mit. edu/explore/) .如 图 2. 7 所 示 。 然 后 单 击 右 上 角 的 Create 
按钮 ,再 使 用 Gmail 账号 登录 进入 AI2 的 开发 环境 。 

进入 AI2 开发 环境 后 ,会 显示 已 经 建立 的 工程 列表 ,如 图 2. 8 所 示 ; 如 果 用 户 是 首次 
使 用 AI2 ,显示 工程 列表 的 区 域 应 该 是 空 着 的 。 从 图 2. 8 中 可 以 看 出 ,笔者 使 用 的 AI2 是 
Beta 版 本 。 


1. 功能 菜单 


Project 菜单 中 提供 了 一 组 管理 工程 的 基本 操作 项 ,包括 显示 所 有 已 经 建立 的 项 目 
(My Projects) ,新建 项 目 (Start new project)、 上 传 已 有 的 项 目 源码 (Import project from 
my computer) ,删除 已 有 选中 项 目 (Delete project) ,保存 项 目 (Save project) 项目 另存 为 
(Save project as) ,设置 便于 后 期 追溯 和 修改 的 检查 点 (Checkpoint) 、 导 出 单个 选中 的 已 
有 项 目 源码 (Export selected project to my computer)、 导 出 所 有 已 有 项 目 源码 (Export 
all projects)、 导 人 秘 钥 (Import keystore)、 导 出 秘 钥 (Export keystore) 和 删除 秘 钥 
(Delete keystore) 。 

Connect 菜单 中 提供 了 连接 设备 或 模拟 器 进行 调试 的 操作 项 ,包括 通过 WiFi 连接 手 
机 调试 的 AI 助手 (AI Companion) 、 启 动手 机 模拟 器 (Emulator) ,使 用 USB 连接 手机 调 
试 (USB) ,连接 软 重启 (Reset Connection) 和 硬 重 启 (Hard Reset), 
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图 2.7 MIT App Inventor 网 站 
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Mame 
ShowMessage 
test002 
Miniweb 
SliderColor 
test001 
TimerClock 


SuperClock 
Login 
FourSeasons 
HelloAl2 


Date Crested 
2014 Mar 30 13:14:25 
2014 Mar 2611:0231 
2014 Mar 3009:1959 
2014 Mar 2614:21:27 
2014 Mar 26 10:18:54 
2014 Mar 25 234256 
2014 Mar 25 22:48:40 
2014 Mar 25 02:20:44 
2014 Mar 24 15:4539 
2014 Mar 23 10:50:22 


Daiewoatedy 
2014 Mar 31 22:21:17 
2014 Mar30 13:14:08 
2014 Mar30 09:48:42 
2014 Mar 27 09:14:36 
2014 Mar 26 10:58:19 
2014 Mar 26 00:0533 
2014 Mar 25 23:16:24 
2014 Mar 25 18:37:49 
2014 Mar 25 18:35:49 
2014 Mar 23 17:39:52 


图 2.8 AD 的 工程 列表 页 面 


Build 菜单 中 提供 了 打包 生成 和 下 载 apk 的 操作 项 ,包括 二 维 码 扫描 下 载 apk 
(provide QR code for .apk) 和 直接 将 apk 文件 下 载 到 计算 机 (save.apk to my 


computer) , 


Help 菜单 中 提供 了 辅助 AI2 开发 的 文档 资源 和 论坛 ,包括 AI2 的 版 本 信息 (About) 、 
AI2 官方 文档 (Library、Get Started, Tutorials) ,故障 排除 页 面 (Troubleshooting) , AI2 论 
坛 (Forums) 和 问题 交流 论坛 (Report an Issue) 。 


可 视 化 开发 Android 应 用 程序 
— tš | + X HEX App Inventor 2 (第 2 收 ) 


2. 快捷 菜单 


快捷 菜单 是 功能 菜单 中 部 分 功能 项 的 快捷 方式 ,其 中 “My Projects” 菜 单 用 来 从 具 
体 的 某 个 项 目 中 快速 切换 到 工程 列表 页 面 ;Guide 菜单 显示 AI2 官方 文档 ,包括 各 阶段 的 
课程 和 教学 资源 ;Report an Issue 菜单 显示 问题 交流 论坛 ;通过 单 击 用 户 的 Gmail 账号 ， 
可 以 选择 退出 AI2(Sign out), 


3. 工程 列表 


工程 列表 列 出 了 已 经 建立 的 所 有 工程 项 目 , 显 示 的 内 容 包括 项 目的 名 称 、 创 建 时 间 和 
修改 时 间 。 单 击 New Project 按钮 可 以 新 建 一 个 工程 项 目 , 单 击 Delete Project 按钮 可 以 
删除 已 选中 的 工程 项 目 。 


2.3.1 界面 编辑 器 


界面 编辑 器 (Designer) 是 AI2 的 重要 组 成 部 分 ,用 户 可 以 以 可 视 化 的 方式 设计 
Android 程序 的 用 户 界 面 ,提供 了 大 量 常用 的 界面 组 件 ,并 可 以 设置 组 件 的 属性 值 ,如 
图 2.9 所 示 。 
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图 2.9 界面 编辑 器 
界面 编辑 器 主要 由 8 个 部 分 组 成 ,各 部 分 的 功能 如 下 所 述 。 
1. 工程 名 称 
这 里 显示 的 是 当前 工程 项 目的 名 称 。 


mom MARM 


2. 屏幕 页 按钮 


Screenl 用 来 选择 需要 编辑 的 屏幕 ; Add Screen 用 来 增加 一 个 新 的 屏幕 页 ; Remove 
Screen 用 来 删除 已 建立 的 屏幕 页 ,但 Screen1 不 能 被 删除 。 


3. 编辑 器 切换 按钮 

用 于 在 界面 编辑 器 (Designer) 和 模块 编译 器 (Blocks) 之 间 切 换 。 
4. 控件 库 (Palette) 

分 类 表 的 显示 了 AI 所 支持 的 全 部 界面 控件 。 

5. 预览 区 (Viewer) 


用 户 在 设计 界面 时 ,可 以 将 “控件 库 ” 中 的 组 件 直接 拖 忠 到 预览 区 内 ,并 在 预览 区 内 对 
组 件 和 布局 进行 调整 。 同 时 在 属性 区 对 组 件 的 属性 进行 修改 ,其 修改 效果 也 会 立即 反应 
在 预览 区 的 该 组 件 上 。 


6. 构件 区 (Components) 
构件 区 树 形 显示 组 件 之 间 的 关系 ,可 以 在 此 区 域 对 组 件 进行 重 命名 和 删除 。 
7. 属性 区 (Properties) 


用 户 可 以 在 这 里 修改 组 件 的 属性 ,如 组 件 的 宽度 、 高 度 、 可 见 性 等 ,所 有 修改 会 立即 反 
应 在 预览 区 。 


8. 资源 区 (Media) 


该 区 域 显 示 工 程 中 使 用 到 的 所 有 资源 素材 ,如 声音 ,视频 或 图 片 。 资 源 区 的 按钮 
(Upload File) 可 以 将 本 地 资源 素材 文件 上 传 到 资源 区 中 。 


2.3.2 模块 编辑 器 


模块 编辑 器 (Blocks) 主 要 用 于 开发 应 用 程序 的 逻辑 和 事件 处 理 , 在 界面 编辑 器 中 单 
击 Blocks 按钮 即 可 切换 至 模块 编辑 器 ,如 图 2. 10 所 示 。 
模块 编辑 器 主要 由 如 下 所 述 3 个 部 分 组 成 。 


1. 模块 库 (Blocks) 


模块 库 提供 逻辑 开发 所 需 的 各 种 模块 ,主要 有 三 类 模块 。 内 置 模 块 类 (Built-in) 提 供 
一 些 常 用 的 基本 模块 ,如 颜色 文本 、 数 学 和 控制 等 模块 ;屏幕 模块 类 (Screen1) 提 供 了 界 
面 开发 时 用 到 的 控件 的 事件 .属性 和 方法 ,但 这 些 模块 与 用 户 在 界面 编辑 器 中 使 用 的 控件 
相关 ,例如 用 户 在 界面 编辑 器 中 只 放置 了 一 个 按钮 Button1, 则 在 模块 编辑 器 中 就 只 会 出 
I Buttonl 的 事件 .属性 和 方法 ;任意 组 件 (Any component) 提 供 了 对 同一 类 型 控件 的 整 
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图 2.10 模块 编辑 器 
体操 作 ,例如 改变 所 有 按钮 的 背景 颜色 .修改 所 有 标签 的 宽度 等 。 
2. 设计 区 (Viewer) 


模块 库 中 的 模块 被 放置 到 设计 区 后 ,在 设计 区 完成 所 有 模块 的 拼接 和 组 装 ,完成 整个 
应 用 程序 的 逻辑 和 事件 处 理 。 此 外 , 右 下 角 有 垃圾 箱 , 可 以 将 设计 区 中 的 模块 拖 忠 到 垃圾 
箱 中 删除 。 


3. 资源 区 (Media) 


模块 编辑 器 的 资源 区 和 界面 编辑 器 的 资源 区 功能 相同 ,两 者 共享 上 传 文件 。 
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AI2 支持 使 用 Android 模拟 器 或 手机 进行 应 用 程序 的 开发 .调试 和 仿真 。 在 进行 程 
序 调试 前 ,读者 需要 先 下 载 AI2 提供 的 软件 包 ,Android 模拟 器 .USB 驱动 和 相关 的 通信 
软件 都 在 这 个 软件 包 中 。 

在 笔者 编写 本 书 期 间 ,AI2 只 提供 Windows 版 本 和 Mac OS X 版 本 的 软件 包 ,GNU/ 
Linux 版 本 的 软件 包 还 在 开发 过 程 中 。 软 件 包 的 下 载 地 址 参考 表 2. 3。 


表 2.3 软件 包 下 载 地 址 


操作 系统 网 址 
Windows http: //appinventor. mit. edu/explore/ai2/windows. html 
Mac OS X http: //appinventor. mit. edu/explore/ai2/mac. html 
GNU/Linux 暂 不 支持 


Windows 版 本 的 下 载 页 面 如 图 2. 11 所 示 , 单 击 Download the installer 选项 ,可 直接 
FA AI 的 软件 包 , 文 件 名 为 AppInventor_Setup_Installer_v_2_1. exe, 文 件 大 小 在 
100MB 左右 。 


T 
MIT App Inventor - 时 Crest | 
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Installing App Inventor 2 Setup on Windows 


Instaling the Windows software for App Inventor Sətup has two parts: 


7. Instaling the App Inventor Setup software package This step is tha same for all Android cevces. and the same for Windows XP. Vista, and 7 
2. ff you choos to uso th» USB cabie to conroct to a devico, then you' mood to install Windows drivers for your Android phono. 


NOTE: App Inventor 2 does not work with Internet Explorar. For Windows users, we recommend using either Chrome or Firefox as your 
browser for use with App Inventor. 


Installing the App Inventor Setup software package 


You must perform the installation from an account that has administrator privileges. Installing via a non-cministrator account is currently not 
supported. 


!f you have installad a previous verson of tn» App Inventor 2 setup tccls, you wil need to uninstall them before installing the latest version. 
Follow the instructions at How tc Update the App inventor Setup Software. 


4. Downicad tho Installer. 

2. Locale the fie Applnventor. Setup Installer v 2 t.exe (~101 MB) in your Downloads fle or your Desktop. The location ofthe download on your 
computer depends on how your browser is configured 

3. Open the fie. 

4. Click through the steps of the instaler Do not change the instalation location but record the installation directory, because you might need ito check 

divers later. The directory will difer depending on your version of Windows and whether or not you are logged in as an administrator. 

5 You may be asked if you want 1o alow a program hom an unknown publisher to make changes to this computar. Click yes. 


图 2.11 Windows 版 本 AI2 软件 包 下 载 页 面 


双击 刚刚 下 载 的 AI2 软件 包 文件 ,进入 AI2 安装 界面 , 单 击 Next 按钮 ,打开 软件 的 
安装 协议 界面 , 单 击 T Agree 按钮 同意 安装 协议 ,如 图 2. 12 所 示 。 

进入 AN 的 目录 选择 界面 ,可 以 看 到 AI2 的 软件 包 安装 需要 170. 5MB 硬盘 空间 ,如 
果 没 有 特殊 要 求 ,可 以 在 AI2 的 默认 目录 (C:\Program Files\AppInventor) 下 直接 安装 ; 
单 击 Next 按钮 ,进入 AI2 的 开始 菜单 选择 界面 ,一 般 不 必修 改 开始 菜单 名 称 ,直接 使 用 
A12 推荐 的 Applnventor Setup 即 可 ,如 图 2. 13 所 示 , 最 后 单 击 Install 按钮 开始 安装 ,如 
图 2.13 所 示 。 

安装 完成 后 ,会 出 现 安装 成 功 界面 ,如 图 2. 14 所 示 。 单 击 Finish 按钮 退出 AI 的 安 
装 程序 。 
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E ë m x 


Welcome to AppInventor Setup 
Setup 


Pleasereview the icense terms before instaling AppInventor Setup. 


Press Page Down to see the rest of the agreement. 


Setup wil guide you through the instalation of AppInventor. 
Setup. 


TE the MIT Aop Inventor Setup Software 
Its recommended that you dose al other applications 

before starting Setup. This wil make it possbie to update 
relevant system fles without having to reboot your 
computer. 


[tt consists of portions of the Android Software Development Kit, 


is governed by the folowing icense: 
1. Introducton. 
Cik Next to continue. 
1.1 The Android Software Development Kit (referred to n this License 
APIs, 
to the terms of this License Agreement. This License Agreement. 


1f you accent the terms of he agreement, dick 1 Agree to continue. You must accept the 
agreenent to install Appinventor Setup. 


(st ) Loma 


图 2.12 AD 软件 包 的 安装 界面 


C repreno seee E ea 


‖ Choose Install Location Choose Start Menu Folder 
Choose the folder in which to install Applnventor Setup. @ Choose a Start Menu folder for the Applnventor Setup shortcuts. 


Setup wil install Applnventor Setup in the folowing folder. To nstal n a different folder, dck Select the Start Menu folder in which you would Ike to create the program's shortcuts. You 
Browse and select another folder. Clck Next to continue. Can also enter a name to create a new folder. 


360 安 全 中 心 
[Accessories 


Ë 


Space required: 170.548 
Space avalable: 24.168 


Nullsoft Install System v3 Da1. 


Installing 


Paman vat vide Aries Seu berg tl Completing AppInventor Setup | 


Setup 


Extract: Appinventor-emulator -data. . 30% 


Appinventor Setup has been installed on your computer. 


Chck Finish to dose Setup. 


Nullsoft Install System v3.01. 


图 2.14 AI 的 安装 成 功 界面 


AI2 软件 包 安装 好 后 ,Windows 桌面 上 会 出 现 名 为 aiStarter 的 快捷 方式 ,如 图 2. 15 
所 示 。 
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aiStarter 是 实现 浏览 器 和 模拟 器 、 浏 览 器 和 手机 之 间 进 行 数据 通信 的 软件 ,因此 用 户 
在 进行 程序 调试 前 ,需要 双击 桌面 上 的 快捷 方式 启动 aiStarter。 在 aiStarter 启动 后 ,会 
出 现 如 图 2. 16 所 示 的 命令 行程 序 界 面 。 其 中 , Platform = Windows 说 明 使 用 的 是 
Windows 系统 ;“Listening on http://127. 0.0.1:8004/” 表 示 aiStarter 在 本 地 端口 8004 
上 工作 ;“Hit Ctrl-C to quit” 提 示 用 户 可 以 通过 按 Ctrl 十 C 键 退 出 aiStarter。 


2.15 aiStarter 的 图 2.16 aiStart 命令 行 界面 
快捷 方式 


25 程序 调试 


AI2 提供 了 多 种 程序 调试 方法 ,不 仅 可 以 在 手机 模拟 器 中 进行 调试 ,还 可 以 通过 
USB 数据 线 或 者 WiFi 连接 实体 手机 进行 调试 。 在 所 有 调试 方法 中 ,使 用 USB 连接 手机 
这 种 方式 简单 ,高效 ,不 需要 依赖 WiFi 网 络 ;但 如 果 附 近 有 可 靠 的 WiFi 网 络 ,使 用 WiFi 
连接 手机 调试 也 是 非常 方便 的 。Android 模拟 器 的 限制 较 多 ,调试 效果 和 速度 还 无 法 和 
手机 媲美 ,因此 在 有 手机 的 情况 下 应 尽量 使 用 手机 进行 调试 。 在 进行 调试 前 ,务必 保证 
aiStart 已 经 启动 ,否则 将 提示 连接 失败 的 信息 ,如 图 2. 17 所 示 。 


Launch the aiStarter program on your computer and then try 
again. Need Help? 


OK 


2.17 aiStart 的 连接 失败 信息 


2.5.1 WiFi 连接 手机 


通过 WiFi 连接 手机 是 AI2 推荐 的 连接 方式 ,用 户 只 需要 在 手机 上 安装 MIT AI2 
Companion 软件 ,就 可 以 让 手机 实时 地 从 AI2 中 自动 获取 调试 界面 , 极 大 地 简化 了 应 用 
程序 的 调试 过 程 。 

在 浏览 器 打开 网 站 http://appinventor. mit. edu/explore/ai2/setup-device-wifi. 
html, 用 户 可 以 通过 扫描 二 维 码 (Play Store) 或 下 载 (APK File) 的 方式 获取 MIT AI2 
Companion 软件 ,如 图 2.18 所 示 。 扫 描 二 维 码 是 AI2 推荐 使 用 的 方式 ,直接 下 载 APK 
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文件 也 是 非常 可 靠 和 快速 的 
Play Store APK File 
Recommended: Automatic updates Manual updates required 


Scan this QR code (or click this link ) Scan this QR code (or click this link ) 
to get the app from the Play Store to download the app directly 


2.18 下 载 MIT AI2 Companion 


运行 MIT AI2 Companion 前 ,需要 开启 手机 的 WiFi 功能 ,因为 MIT AI2 
Companion 是 通过 无 线 局 域 网 将 数据 从 AI2 传递 到 手机 中 的 。 
启动 手机 中 的 MIT AI2 Companion, 手 机 上 应 显示 如 图 2. 19 所 示 的 软件 界面 。 


Q = "al 28% 12:24 


MIT App Inventor 2 Companion 


type in the 6-digit code 
-Or 


scan the QR code 


Six Digit Code 


scan QR code 


Your IP Address is: 192.168.0.42 
Version: 2.16ai2zx1 


2.19 MIT AI2 Companion 界面 


在 手机 端 准 备 好 后 ,在 AI2 的 菜单 栏 中 单 击 Connect 菜单 ,然后 选择 AI Companion 
命令 ,通知 AI2 尝试 通过 WiFi 连接 手机 ,如 图 2. 20 所 示 。 

页 面 上 会 弹出 一 个 对 话 框 , 提 供 了 一 个 6 个 字母 组 成 的 验证 码 (code) 和 二 维 码 ,如 
图 2.21 所 示 。 用 户 可 以 在 手机 MIT AI2 Companion 的 Six Digit Code 文本 框 中 输入 验 
证 码 ,或 者 通过 扫描 二 维 码 的 方法 与 手机 连接 。 

在 输入 验证 码 和 二 维 码 后 .手机 很 快 会 打开 应 用 程序 的 调试 界面 。 这 时 只 要 不 按 下 
手机 的 回 退 键 和 HOME 键 .调试 界面 会 一 直 保留 。 在 AI2 界面 编辑 器 中 的 修改 ， 会 直 
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MITApp Inventor 2 
Beta 


TimerClock 
Emulator 
USB 


User Interface J Reset Connection lents in Viewer 


国 Button 3 Hard Reset 


Project» — Connect- — Buid- Help + 


图 2.20 启动 AI 助手 


Connect to Companion 


Launch the MIT Al2 Companion on your device 
and then scan the barcode or type in the code 
to connect for live testing of your app. 

i 2 " 


[m] [m] Your code is: 


[n] nwbakw 
. 


图 2.21 设备 连接 的 验证 码 和 二 维 码 
接 反 映 在 手机 应 用 程序 的 调试 界面 上 ,无 须 用 户 多 次 连接 手机 。 
2.5.2 USB 连接 手机 


与 WiFi 连接 相 比 ,使 用 USB 连接 手机 相对 复杂 一 些 。USB 连接 手机 需要 满足 的 条 
件 包 括 aiStart 已 经 启动 .开启 手机 的 “USB 调试 ”手机 在 电脑 中 已 经 驱动 .设置 手机 为 
“大 规模 存储 器 (mass storage device) ”模式 。 

开启 手机 的 “USB 调试 ?的 方法 根据 Android 系统 的 版 本 有 所 差异 。 一 般 的 Android 
系统 在 “设置 "界面 中 选择 “开发 者 选项 ”选项 进入 “开发 者 选项 "界面 ,然后 勾 选 “USB 调 
试 ?选项 即 可 。 在 Android 4. 2 及 以 上 版 本 中 ,开发 者 选项 ?选项 默认 是 隐藏 的 ,需要 在 
“设置 "界面 中 选择 “关于 手机 ”选项 进入 “关于 手机 ”界面 ,然后 连续 单 击 “ 版 本 号 " 数 次 , 才 
可 以 将 隐藏 的 “开发 者 选项 ”选项 显示 出 来 。 

手机 在 与 电脑 连接 后 ,会 提示 用 户 选 择 连接 模式 ,此 时 应 选择 “大 规模 存储 器 ”模式 ， 
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而 不 是 “媒体 设备 (media device) ”等 其 他 选项 。 

手机 驱动 的 问题 也 很 棘手 ,虽然 有 通用 的 驱动 程序 ,但 不 能 保证 所 有 手机 都 可 以 使 用 
通用 驱动 程序 ,用 户 的 手机 被 正常 驱动 是 进行 USB 连接 手机 调试 的 基础 。 如 图 2.22 所 
示 的 网 页 可 以 测试 手机 是 否 被 正确 驱动 以 及 aiStarter 是 否 已 经 启动 ,这 个 网 页 的 网 址 是 


http://appinventor. mit. edu/test/。 


MIT App Inventor 2 Connection Test 
Is aiStarter running? 
YES, aiStarter v2.2 running! 


ls your phone connected via USB? 


YES, your phone is connected via USB! 


图 2.22 连接 测试 网 页 


一 切 准 备 就 绪 后 ,在 菜单 栏 中 单 击 Connect 菜单 项 ,然后 选择 USB 选项 ,使 用 USB 
连接 手机 。 然 后 界面 上 会 出 现 Connecting via USB Cable 的 提示 对 话 框 , 如 图 2. 23 
所 示 o 

手机 在 与 AI2 成 功 连接 后 ,会 尝试 从 MIT 的 服务 器 上 获取 数据 ,并 将 这 些 数 据 传递 
到 手机 上 。 用 户 在 看 到 如 图 2. 24 所 示 的 手机 界面 后 不 久 , 就 可 以 打开 在 调试 的 应 用 程序 
界面 。 


Pç += FE3ETUEIUTEE 
MIT App Inventor 2 Companion 


MIT App Inventor 2 


Connecting via USB Cable 


Cancel 


图 2.23 尝试 通过 USB 连接 手机 提示 信息 图 2.24 等 待 获取 模块 


2.5.3 Android 模拟 器 


启动 Android 模拟 器 的 方法 非常 简单 ,只 要 在 AI2 的 菜单 栏 中 单 击 Connect 菜单 项 ， 
然后 选择 Emulator 命令 ,就 可 以 启动 Android 模拟 器 。 在 模拟 器 的 启动 过 程 中 ,首先 会 
出 现 Starting the Android Emulator 提示 信息 ,如 图 2. 25 所 示 。 

在 模拟 器 启动 提示 界面 出 现 的 同时 ,aiStarter 中 会 同时 出 现 一 系列 的 连接 信息 ,如 
图 2. 26 所 示 。 

然后 会 弹出 Android 模拟 器 的 运行 界面 ,中 央 显 示 ANDROID 字样 ;片刻 后 模拟 器 
完全 启动 ,会 出 现 Android 系统 的 锁定 界面 ;最 后 ,模拟 器 会 自动 运行 MIT App Inventor 
2 Companion 软件 ,出 现 有 MIT App Inventor 2 字样 的 画面 ,这 就 表示 模拟 器 已 经 准备 
好 ,可 以 进行 程序 调试 了 ,如 图 2.27 所 示 。 


Starting the Android Emulator 


Cancel 
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图 2 


.25 模拟 器 启动 提示 界面 
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图 2.26 aiStarter 的 连接 信息 


5554:<build> = E 


(No service) 
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Thursday, March 27 
© Charging (50%) 


CE 
MIT App Inventor 2 Companion 


图 2.27 Android 模拟 器 
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Android 模拟 器 可 以 仿真 手机 的 绝 大 部 分 硬件 和 软件 功能 ,支持 加 载 SD 卡 映 像 文 
件 , 更 改 模拟 网 络 状态 、 延 迟 和 速度 ,模拟 电话 呼叫 和 接收 短信 等 ;支持 将 屏幕 当成 触摸 屏 
使 用 ,可 以 使 用 鼠标 单 击 屏幕 模拟 用 户 对 Android 设备 的 触摸 操控 。 在 Android 模拟 器 
上 有 普通 手机 常见 的 各 种 按键 ,如 音量 键 , 挂 断 键 , 返 回 键 和 菜单 键 等 。 但 Android 模拟 
器 仍 不 支持 的 功能 包括 接听 真实 电话 呼叫 `\USB 链接 、 摄 像 头 捕获 .连接 状态 检测 .电池 
"t AC 电源 检测 SD 卡 插 拔 检查 和 蓝牙 设备 等 。 

以 上 是 利用 AI 进行 Android 应 用 开发 的 前 期 准备 工作 。 如 果 在 操作 过 程 中 遇 到 
任何 问题 ,可 以 参考 MIT App Inventor 疑难 解答 (Troubleshooting) 网 页 (http:// 


appinventor. mit. edu/explore/ai2/support/troubleshooting) 。 


ORE 


1. 安装 AI2 的 软件 包 , 并 记录 在 安装 过 程 中 所 遇 到 的 问题 。 
2. 从 资源 网 站 上 下 载 AI2 的 源 代码 文件 (aia) ,尝试 使 用 模拟 器 和 手机 进行 调试 。 
3. 分 析 使 用 WiFi 连接 手机 调试 程序 的 优 缺点 。 
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本 章 主要 介绍 开发 AI2 应 用 程序 的 基础 知识 和 基本 方法 。 通 过 本 章 内 容 的 学 习 , 读 
者 可 以 了 解 开发 AI 应 用 程序 的 过 程 和 方法 ,进一步 掌握 应 用 的 界面 部 分 和 逻辑 部 分 的 
开发 方法 。 

本 章 将 详细 介绍 如 何 开 发 第 一 个 AI2 程序 HelloAI2。 在 第 2 章 的 基础 上 ,讲解 如 何 
使 用 AI2 建立 新 工程 ,使 用 界面 设计 器 开发 用 户 界面 ,使 用 模块 编辑 器 开发 程序 逻辑 以 
及 使 用 手机 或 模拟 器 进行 程序 调试 。 


° 了解 AI2 的 程序 开发 流程 
° 掌握 界面 编辑 器 的 使 用 方法 
° 掌握 模块 编辑 器 的 使 用 方法 


31 创建 新 工程 


HelloAI2 示例 非常 简单 ,界面 如 图 3. 1 所 示 ,用 户 在 界面 上 单 击 “ 请 按 我 "按钮 , 则 会 
在 按钮 下 方 出 现 “ 你 好 !1App Inventor 2” 文 本 。 

在 用 Gmail 账号 登录 后 ,可 直接 进入 AI2 W OAOE 
工程 管理 界面 ,如 图 3. 2 所 示 。 四 

因为 是 首次 进入 工程 管理 界面 ,因此 这 里 在 
Projects 页 面 中 并 没有 任何 已 经 建立 的 工程 。 同 
时 AI2 会 提示 用 户 如 何 创建 新 工程 .如 何 访问 旧 
版 本 的 App Inventor 以 及 如 何 进行 手机 或 模拟 
器 的 调试 等 ,如 图 3. 3 所 示 。 

建立 新 工程 第 一 步 是 单 击 工程 管理 界面 
左上 角 的 New Project 按钮 .也 可 以 通过 菜单 
命令 Project Start new project 实现 ,如 图 3. 4 
BUR S 

打开 “创建 新 工程 ”对 话 框 ,在 Project name 
文本 框 中 输入 HelloAI2 作为 工程 名 称 ,然后 单 
击 OK 按钮 即 可 完成 工程 创建 ,如 图 3. 5 Bros. 图 3.1 HelloAD 示例 界面 
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Repot wamersuperBgmailcom 
an Issue . 


图 3.2 AL 的 工程 管理 界面 


Welcome to App Inventor 2! 


You don't have any projects in App Inventor 2 yet. 
To learn how to use App Inventor, click the “Guide” 
link at the upper right of the window; or to start 
your first project, click the "New" button at the 
upper left of the window. 


Where did my projects go? If you had projects 
but now they're missing, you are probably looking 
for App Inventor version 1. It's still available here: 
beta appinventor.mit edu 


Happy Inventing! 


Welcome to MIT App Invenlor 2 


Got an Android phone or tablet? Find out how to 
Set up and connect an Android device. 
Don't have an Android device? Find out how to 
Set up and run tho Android emulator. 


(Emulator and USB connections are currently for Mac 
and Windows only. Support for Linux is coming soon!) 
(Support for Internet Explorer is coming soon?) 


Continua, 
图 3.3 AN2 的 提示 信息 
Project» Connect» — Buid- Help + 
mm MIT App Inventorz Projete 


| My Projects 


Start new project 


Import project (.aia) from my computer ... 


图 3.4 建立 新 工程 


Create new App Inventor project 


Project 
name: 


Cancel 


图 3.5 新 工程 命名 
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工程 创建 完成 后 ,Projects 页 面 中 会 显示 刚刚 创建 的 工程 ,如 图 3. 6 所 示 。 工 程 名 称 
为 HelloAI2 ,工程 创建 时 间 是 “2014 Mar 23 10:50:22”。 因 为 是 新 工程 ,所 以 工程 的 修改 
时 间 和 创建 时 间 相 同 。 


Name Date Created Date Modified Y 
Ü HelloAI2 2014 Mar 23 10:50:22 2014 Mar 23 10:50:22 


图 3.6 工程 列表 


工程 名 称 HelloAI2 前 有 一 个 复 选 框 ,主要 是 用 于 删除 该 工程 。 如 果 勾 选 这 个 复 选 
框 ,Delete Project 按钮 就 会 变 为 可 单 击 的 状态 ,如 图 3.7 所 示 。 用 户 可 以 同时 选中 多 个 
工程 ,一 次 性 删除 这 些 工程 项 目 。 


Name Date Created Date Modified y 
© HelloAI2 2014 Mar 23 10:50:22 2014 Mar 23 10:50:22 


图 3.7 删除 工程 


在 用 户 单 击 Delete Project 按钮 后 ,AI2 会 提示 用 户 是 否 真 要 删除 该 工程 ,如 图 3. 8 
所 示 ,再 次 确认 后 ,工程 Hello A12 会 被 正式 删除 。 


ai2.appinventor.mit.edu 上 的 网 页 显示 : x 


Are you really sure you want to delete this project: 


HelloAI2 
[= J = | 


图 3.8 删除 工程 确认 对 话 框 


32 界面 开发 


首先 打开 新 建立 的 工程 ,AI2 会 自动 打开 工程 ,并 进入 界面 编辑 页 面 ,如 图 3.9 所 示 。 

AI2 会 在 每 个 新 建 工程 中 自动 创建 一 个 屏幕 页 Screenl ,在 Viewer( 预 览 ) 区 可 以 看 
到 屏幕 页 Screenl 的 显示 效果 。 屏 幕 页 是 界面 控件 的 承载 体 , 用 户 可 以 在 屏幕 页 上 面 放 
置 各 种 界面 控件 和 界面 布局 。 

然后 对 屏幕 页 Screenl 的 属性 进行 修改 。 先 在 构件 区 (Components) 中 选中 屏幕 页 
Screen1, 然 后 在 属性 区 (Properties) 中 修改 标题 (Title) 属 性 ,将 默认 的 Screenl 更 改 为 
Hello App Inventor 2。 屏 幕 页 Screenl 属性 区 修改 后 ,预览 区 中 的 显示 内 容 会 立即 更 改 
为 Hello App Inventor 2, 如 图 3. 10 所 示 。 
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图 3. 10 


HelloAI2 示例 的 界面 设计 器 


Viewer 


O Display hidden components in Viewer 


Hello App Inventor 2 


HelloA12 示例 的 屏幕 页 标题 
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接 下 来 向 HelloAI2 示例 添加 一 个 按钮 ,并 修改 按钮 的 文字 、 大 小 和 颜色 。 从 左 侧 控 
件 库 (Palette) 的 用 户 界 面 (User Interface) 区 域 中 将 按钮 (Button) 控 件 拖 电 到 屏幕 页 
Screenl 上 。 屏 幕 页 上 立即 会 出 现 一 个 按钮 ,显示 的 内 容 是 默认 字符 串 Text for Buttonl, 
如 图 3. 11 所 示 。 


Palette Viewer 

User Interface CiDisplay hidden components in Viewer 
国 Button 3 

RÀ CheckBox * Hello App Inventor 2 
@ Clock 7 
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Layout 

Media 


Drawing and Animation 


Sensors 


Social 
3.11. 添加 按钮 


AI 会 为 每 个 拖 入 预览 区 的 控件 自动 命名 ,命名 规则 是 “控件 类 型 十 编号 ”, 编 号 是 从 
1 向 上 递增 的 。 例 如 ,刚刚 的 按钮 会 被 命名 为 Buttonl. 


如 果 再 生产 一 个 按钮 , 则 会 被 命名 为 Button2。 Components | 
如 果 用 户 界 面 上 的 控件 较 少 ,使 用 AI2 自动 生成 的 | 9 国 sereen1 
命名 会 比较 方便 ;但 如 果 界 面 控 件 较 多 ,应 该 给 控件 起 一 国 Buton 


个 容易 识别 的 名 称 , 便 于 后 续 的 操作 。 

这 里 将 按钮 的 名 称 更 改 为 ButtonClickMe, 方 法 是 先 
从 构件 区 (Components) 中 选中 Buttonl, 然 后 单 击 
Rename 按钮 即 可 更 改 控件 名 称 , 如 图 3. 12 所 示 。 

给 控件 重 命名 只 需 在 New name 文本 框 中 输入 新 名 
PK“ ButtonClickMe” 即 可 , 单 击 OK 按钮 后 ,构件 区 
(Components) 的 按钮 名 称 即 被 修改 为 "ButtonClickMe”, 如 
图 3. 13 所 示 。 : 

下 面 按照 表 3. 1 来 修改 Buttonl 按钮 的 属性 ,目的 图 3.12 构件 区 中 的 Buttoni 按钮 


Rename Delete 
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Rename Component 
Old name: 


New name: 


Cancel | 


是 让 按钮 看 起 来 更 加 醒目 , 且 可 以 显示 中 文 提示 “请 按 我 ”。 


ButtonClickMe 


OK 


图 3.13 重 命名 控件 


表 3.1 Buttonl 按钮 属性 


属性 默认 值 修改 值 
BackgroundColor Default Green 
FontSize 14.0 30 
Text Text for Buttonl 请 按 我 
Width Automatic Fill parent 


修改 Buttonl 按钮 的 属性 的 方法 可 以 参考 图 3. 14。 首 先 将 按钮 的 背景 颜色 修改 为 
绿色 ,修改 方法 是 将 BackgroundColor 属性 由 默认 的 Default 改 为 Green。 修 改 背景 颜色 
时 会 弹出 颜色 面板 ,直接 单 击 绿色 的 方块 就 可 以 了 。 修 改 Buttonl 按钮 的 字体 大 小 是 通 
过 修改 FontSize 属性 实现 的 ,FontSize 属性 的 默认 值 是 14. 0 ,将 其 修改 为 30 即 可 。Text 
属性 是 控制 按钮 的 显示 内 容 , 将 其 从 默认 的 Text for Buttonl 改 为 “请 按 我 ”。 


[gain M =< 
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Fontltalic 
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FontSize 
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BackgroundColor 


FontTypeface 
| default 


图 3.14 


default — "| 
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Width 
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Buttonl 按钮 属性 修改 
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Width 属性 是 控制 按钮 宽度 的 属性 ,默认 值 是 Automatic, 表 示 按 钮 的 宽度 会 自 适应 
文字 的 长 度 ; 选 中 Fill parent 单 选 按钮 ,按钮 的 宽度 会 填充 满 整个 父 控件 ,按钮 Buttonl 
就 采用 这 种 属性 ;最 后 一 个 选项 是 将 宽度 设置 为 固定 的 值 ,这 里 用 像素 作为 单位 。 修 改 按 
钮 宽度 属性 可 以 参考 图 3. 15。 

按钮 Buttonl 的 属性 设置 完成 后 ,预览 区 的 界面 应 如 图 3. 16 所 示 。 因 为 按钮 宽度 属 
性 设置 为 Fill parent, 所 以 按钮 的 宽度 达到 了 上 层 控件 允许 的 最 大 值 。 


Hello App Inventor 2 


Automatic 
* Fill parent 
pixels 


Cancel OK 


3.15 修改 按钮 宽度 属性 3.16 HelloA12 示例 的 预览 界面 
下 一 步 是 向 HelloAI2 示例 中 添加 一 个 标签 。 标 签 属于 常用 控件 ,一 般 用 来 显示 文 
字 , 位 置 在 控件 库 的 User Interface 区 域 。 标签 控件 被 拖 忠 到 屏幕 页 后 ,会 命名 为 


Labell ,并 会 自动 出 现在 Buttonl 按钮 控件 的 下 方 ,显示 的 文字 为 Text for Labell, 如 
图 3.17 所 示 。 


Hello App Inventor 2 


请 按 我 


图 3.17 标签 的 显示 内 容 

参考 表 3. 2 修改 Labell 标签 的 字号 、 显 示 内 容 和 宽度 ,修改 后 的 显示 结果 如 图 3. 18 
所 示 。 

到 这 里 ,HelloAI2 示例 的 界面 部 分 已 经 完成 了 .AI2 是 自动 保存 用 户 修改 信息 的 ,但 
也 可 以 通过 选择 “Project>Save project” 命 令 强 制 保 存 工程 。 
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Hello App Inventor 2 


383.2 Labell 属性 请 按 我 


属性 默认 值 修改 值 显示 信息 
FontSize 14.0 20 
Text Text for Labell | 显示 信息 
Width Automatic Fill parent 3.18 Labell 标签 属性 修改 后 的 界面 
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单 击 界面 编辑 器 右上 角 的 Blocks 按钮 ,可 以 进入 AI2 的 模块 编辑 器 ,如 图 3. 19 所 
示 , 在 这 里 可 以 进行 应 用 的 逻辑 部 分 开发 。 


pp MIT App. uum E GUYS l masr nos 0pm cA Dese e | 
| 
HelloAI2 ED 


国 vwrooes 
国 pocedues 
日 seem 

国 eunocicove 
iA] abel 


@ Anycomponent | 450 Ao 
Show Warnings 


图 3.19 模块 编辑 器 


在 HelloAI2 示例 中 ,要 实现 的 逻辑 非常 简单 ,就 是 用 户 单 击 “ 请 按 我 "按钮 后 ,标签 显 
示 的 文字 由 “显示 信息 "更改 为 “你 好 ! App Inventor 2”。 这 里 可 以 找到 3 个 关键 的 元 素 ， 
就 是 “请 按 我 "按钮 .标签 和 文字 “你 好 ! App Inventor 2”; 两 个 关键 动作 , 即 “ 单 击 ” 和 “ 显 
示 ”。“ 单 击 ”动作 对 应 “请 按 我 "按钮 控件 ,而 “显示 ”动作 对 应 标签 控件 。 

这 样 分 析 来 看 ,只 要 在 模块 编辑 器 中 找到 “按钮 单 击 事件 ”“ 标 签 内 容 修 改 模 块 " 和 
“内 容 的 承载 体 ”, 就 可 以 完成 上 述 逻 辑 开发 。 事 实 上 ,这 样 的 模块 在 模块 编辑 器 中 可 以 很 
容易 找到 ,如 图 3. 20 Bros 

下 面 首先 说 明 如 何 找到 “按钮 单 击 事件 ”"。 首 先 单 击 屏 幕 左 侧 的 Blocks- Screen] — 
ButtonClickMe 控件 ,弹出 浮动 菜单 形式 的 事件 模块 列表 ,第 一 项 便 是 “按钮 单 击 事件 ” 
(when ButtonClickMe. Click) ,如 图 3. 21 所 示 。 
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Dco aues CMH 


Æ 3.20 HelloAD 示例 所 需 的 模块 
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3.21 按钮 单 击 事件 


找到 “标签 内 容 修改 模块 "的 方法 是 连 击 Blocks Screenl— Labell 控件 ,然后 从 弹出 
的 菜单 中 选择 set Labell. Text to 项 ,如 图 3.22 所 示 。 
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图 3.22 标签 内 容 修改 模块 


“内 容 的 承载 体 " 在 本 示例 中 应 是 一 段 文 本 信息 (文本 模块 ) ,位 置 在 Blocks Built-in» 
Text 控件 中 ,如 图 3. 23 所 示 。 

文本 模块 的 默认 显示 内 容 为 空 ,将 其 内 容 修改 为 “你 好 !App Inventor 2”"。 用 户 只 要 
用 鼠标 单 击 文本 模块 的 空白 区 域 ,然后 就 可 以 进行 输入 修改 了 ,如 图 3. 24 所 示 。 

最 后 ,将 所 有 3 个 模块 按照 预先 设 定好 的 逻辑 拼装 在 一 起 ,其 过 程 就 像 拼 图 游戏 , 拼 
装 后 的 结果 如 图 3. 25 所 示 。 
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图 3.23 文本 模块 


EA 一 


3.24 修改 文本 模块 显示 内 容 


when -Click 


OO set 
= 


图 3.25 模块 拼装 


在 AI2 中 ,如 果 两 个 模块 成 功 拼装 在 一 起 ,将 会 发 出 清脆 的 “ 味 ” 的 声音 ,而 且 两 个 模块 


的 边缘 是 完全 咬合 在 一 起 的 。 反 之 ,如 果 两 个 模块 无 法 
拼装 , 则 不 会 有 任何 反应 。 在 拼装 过 程 中 不 难 发 现 ， 
ButtonClickMe. Click 模块 和 Labell. Text 模块 的 卡 
槽 是 互相 吻合 的 ,表明 这 样 的 模块 是 可 以 拼装 在 一 起 
的 ;同样 ,Labell. Text 模块 和 文本 模块 的 卡 槽 也 是 互 
相 吻 合 的 。 相 反 ,ButtonClickMe. Click 模块 和 文本 模 
块 的 卡 槽 并 不 匹配 ,这 两 个 模块 就 无 法 拼装 在 一 起 。 
这 样 的 设计 可 以 在 很 大 程度 上 避免 出 现 模块 的 拼装 
错误 。 

如 图 3. 26 所 示 ,AfI2 的 模块 编辑 器 中 ,Blocks 区 
域 包含 Build-in ,Screenl 和 Any component 4 3 个 子 
项 。 其 中 ,Build-in 是 内 建 模块 区 ,与 界面 无 关 的 模块 
都 安置 在 这 里 ,包括 控制 模块 .逻辑 模块 .数学 模块 、 
文本 模块 .列表 模 块 .颜色 模 块 、 变 量 模块 和 函数 模 
块 。Screenl 是 控件 模块 区 ,是 与 用 户 界 面 控 件 相 关 
的 事件 .属性 和 方法 模块 ,这 里 的 模块 类 型 和 数量 会 
根据 用 户 界面 中 所 包含 的 控件 数量 变化 而 变化 。 例 
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图 3.26 ”模块 编辑 器 的 Blocks 区 域 
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如 在 HelloAI2 的 示例 中 ,界面 上 只 有 两 个 控件 (按钮 和 标签 ), 所 以 在 Screenl 控件 模块 
区 中 只 有 两 个 控件 的 模块 列表 。Any component 是 高 级 模块 区 ,是 对 所 有 同类 型 控件 进 
行 操控 的 模块 ,例如 全 部 按钮 的 操作 或 全 部 标签 的 操作 等 。 


34 调试 运行 


AI2 支持 模拟 器 和 手机 调试 ,如 果 条 件 允 许 ,应 尽量 选择 手机 进行 调试 。 因 为 模拟 器 
在 响应 速度 .显示 效果 和 对 硬件 支持 方面 存在 一 定 projets connects — Build Helps 
的 不 足 , 且 使 用 手机 调试 完毕 后 ,开发 者 可 以 将 程序 ENHEERAMDEG 
安装 在 手机 中 ,与 朋友 和 家 人 分 享 。 

笔者 这 里 采用 USB 连接 手机 的 方式 进行 调试 ， 
这 种 方式 不 需要 无 线 网 络 ,而 且 不 需要 输入 验证 码 ， 
似乎 更 加 易 用 一 些 。 用 USB 数据 线 将 手机 和 计算 
机 连接 后 , 单 击 菜单 Connect ,在 弹出 的 菜单 中 选择 
USB, 如 图 3. 27 所 示 。 

片刻 后 ,手机 屏幕 上 会 显示 HelloAI2 示例 的 界 
面 , 单 击 “ 请 按 我 "按钮 后 ,将 在 按钮 下 方 显 示 “ 你 好 !App Inventor 2” 的 字样 ,如 图 3. 28 
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Reset Connection 


Hard Reset 


图 3.27 通过 USB 连接 手机 设备 


所 示 。 
i 8 
Hello App Inventor 2 Hello App Inventor 2 
请 按 我 请 按 我 
显示 信息 你 好 ! App Inventor 2 


图 3.28 HelloAD 示例 的 运行 结果 


CAS e 


l. 使 用 AI2 开发 应 用 程序 ,界面 编辑 器 和 模块 编辑 器 的 功能 各 是 什么 ? 

2. 分 析 哪 种 程序 调试 方法 更 加 适合 你 ,为 什么 ? 

3. 尝试 将 HelloAI2 示例 的 代码 和 apk 文件 下 载 到 本 地 计算 机 ,并 想 办 法 将 apk X 
件 安装 在 手机 上 。 


程序 设计 基础 


在 程序 设计 过 程 中 ,不 可 避免 地 会 使 用 条 件 判 断 、 循 环 、 函 数 和 列表 等 模块 ,用 户 可 以 
选择 所 需 的 结构 模块 ,最 终 实现 完整 的 程序 逻辑 。 通 过 本 章 内 容 的 学 习 , 读 者 可 以 基本 党 
握 这 些 模块 的 使 用 方法 和 应 用 场景 。 


本 章 学 习 目标 

。 掌握 条 件 判 断 模块 的 使 用 方法 

。 了 解 布尔 表达 式 

。 掌握 列表 的 使 用 方法 以 及 列表 项 的 添加 与 删除 

。 掌握 循环 模块 的 使 用 方法 

° 掌握 函数 模块 的 使 用 方法 以 及 函数 的 参数 和 返回 值 
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在 生活 中 经 常会 遇 到 类 似 于 “如 果 明 天 天 气 好 ,我 们 就 去 郊游 ;如 果 天 气 不 好 ,就 不 去 
了 ”“ 如 果 成 绩 能 到 90 分 ,就 会 奖励 你 ; 当然, 如果 成 绩 还 没有 达到 60 分 ,就 会 批评 你 的 ” 
这 样 的 说 法 ,这 里 的 “如 果 …” 就 是 条 件 判断 ,“ 如 果 ” 后 面 描述 的 情况 称 为 “条 件 ”, 所 以 这 
样 的 句子 形式 可 以 总 结 为 “如 果 十 条 件 , 条 件 成 立时 可 以 做 的 事情 ”。 

在 程序 设计 中 , AI2 提供 了 用 于 条 件 判断 的 if-then 模块 ,可 以 实现 简单 的 条 件 判断 
功能 ,如 图 4.1 所 示 。 

为 了 处 理 各 种 可 能 发 生 的 复杂 判断 情况 ,if-then 模块 可 以 演变 成 为 更 加 复杂 的 判断 
模块 ,这 里 暂时 将 其 称 为 “扩展 ”, 那 么 if-then 扩展 模块 有 无 限 多 种 形式 ,图 4. 2 中 列举 了 
其 中 的 一 部 分 。 


4.1 if-then 模块 4.2 if-then 扩展 模块 


mam 程序 设计 基础 


4.1.1 布尔 表达 式 


if- then 模块 和 if…then 扩展 模块 中 ,所 有 假设 条 件 是 拼接 在 槽 让 上 的 ,这 些 “ 假 设 
条 件 " 实 际 上 是 一 种 布尔 表达 式 ,最 终 只 有 true ÉD RII false( 假 ) 两 个 取 值 。 

最 简单 的 布尔 表达 式 莫 过 于 等 式 (equality) ,这 种 布尔 表达 式 用 来 测试 一 个 值 是 否 与 
另 一 个 值 相 同 ,可 以 是 一 个 简单 的 等 式 , 例 如 2 一 4; 也 可 以 是 一 个 复杂 一 些 的 等 式 , 例 如 
score 一 60, 如 图 4.3 所 示 。 

AI2 支持 的 关系 运算 符 有 等 于 ,不 等 于 .小 于 .小 于 等 于 .大 于 及 大 于 等 于 ,如 图 4. 4 
所 示 。 使 用 这 些 关系 运算 符 就 可 以 做 出 一 些 较为 复杂 的 条 件 判断 。 


图 4.3 各 种 等 式 图 4.4 AD 支持 的 关系 运算 符 


AI2 支持 的 逻辑 运算 符 有 相等 (一 ) 、 不 相等 、 真 (true)\ 假 (false)、 与 (and), 或 (or) 和 
非 (not) ,如 图 4.5 所 示 。 


P DET EFL [CT UL [SS | 
图 4.5 AD 支持 的 逻辑 运算 符 


使 用 关系 运算 符 和 逻辑 运算 符 , 可 以 表达 稍微 复杂 一 些 的 判断 条 件 , 例 如 图 4.6 所 示 
的 “高 危 工种 的 招聘 条 件 是 : 考试 成 绩 大 于 等 于 60 分 ,初级 工作 在 5 年 以 上 或 高 级 工作 
在 两 年 以 上 ,而 且 必 须 是 未 婚 ”。 使 用 到 了 逻辑 运算 符 and、or 和 not, 以 及 像 大 于 、 小 于 等 
的 一 些 关 系 运 算 符 。 


4.6 复杂 的 条 件 判断 


除 此 之 外 ,还 有 一 些 判 断 模块 返回 的 值 是 布尔 类 型 的 ,这 些 模 块 也 可 以 作为 布尔 表达 
式 拼 接 在 if then 模块 的 模 if 上 ,如 图 4.7 所 示 。 通 过 观察 可 以 发 现 ,这 些 模块 有 一 个 共 
同 的 特点 ,都 是 “is. . ?” 的 形式 ,所 以 读者 也 较为 容易 在 众多 的 模块 中 将 其 辨认 出 来 。 

还 有 一 个 比较 特别 的 模块 ,就 是 if…then…else 模块 ,如 图 4.8 所 示 。 这 个 模块 会 返 
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回 一 个 布尔 值 ,进行 条 件 判 断 时 ,首先 判断 模 if 中 的 条 件 ,如 果 i£ AR tF 29 PCS B| Ind 
then 条 件 的 布尔 值 ;如 果 if 的 条 件 为 假 , 则 会 返回 else 条 件 的 布尔 值 。 


Rs 


is a number? 


is in list? thing 
图 4.7 可 用 于 条 件 判断 的 模块 图 4.8 特殊 的 if-then-else 模块 
4.1.2 ”if…then 模块 


在 AI2 的 开发 过 程 中 ,逻辑 部 分 主要 在 模块 编辑 器 (Blocks Editor) 中 进行 设计 。 在 
模块 编辑 器 中 ,if…then 模块 的 位 置 在 Blocks>Built-in>Control 控件 中 ,如 图 4.9 所 示 。 


Blocks Viewer 
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图 4.9 if- then 模块 


ife then 模块 的 结构 和 执行 流程 如 图 4. 10 所 示 , 其 中 槽 计 用 来 拼接 条 件 , 槽 then 用 
来 拼接 需要 执行 的 动作 。 

if…then 模块 的 执行 流程 是 先 判断 槽 if 的 
条 件 是 否 为 真 (条 件 成 立 ) ,如 果 条 件 成 立 , 则 执 
ITAN then 中 的 其 他 模块 ;如 果 条 件 为 假 ( 条 件 不 
成 立 ) , 则 不 执行 槽 chen 中 的 其 他 模块 。 下 面 给 
出 一 个 判断 成 绩 是 否 及 格 的 示例 ,用 来 说 明 如 何 
使 用 if…then 模块 。 

程序 中 的 让 …then 模块 用 来 判断 全 局 变量 《图 4.10 if…then 模块 结构 与 执行 流程 
score 是 否 小 于 60。 如 果 score 小 于 60, 条 件 判 
断 部 分 会 返回 true,if…then 模块 执行 then 中 的 内 容 , 将 Labell 标签 的 显示 内 容 修改 为 
“不 及 格 ”。 反 之 ,如 果 条 件 不 成 立 , 条 件 判断 部 分 返回 false, if- then 模块 跳 过 then 中 的 
内 容 , 如 图 4.11 所 示 。 
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to 


图 4. 11 if…then 模块 示例 


在 这 个 示例 中 initialize global 模块 用 来 定义 全 局 变量 ,所 谓 全 局 变量 ,就 是 可 以 在 | 
程序 的 任何 地 方 使 用 的 变量 ,要 注意 的 是 这 样 的 变量 名 称 不 能 够 重复 。 这 里 定义 了 一 个 | 
全 局 变量 score, 用 来 代表 考试 成 绩 , 初 始 值 设 置 为 90。 全 局 变量 在 Blocks— Built-in 
Variables 控件 中 ,如 图 4. 12 所 示 。 其 中 ,name 表示 变量 名 ,由 用 户 根据 需要 修改 ,在 这 
个 示例 中 变量 名 修改 为 score,to 后 面 拼接 变量 的 初始 值 。 
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nitialize global 
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图 4.12 定义 全 局 变量 


定义 全 局 变量 后 ,在 Blocks Built-in Variables 控件 中 使 用 get 模块 获取 并 使 用 全 
局 变量 ;也 可 以 在 Blocks— Built-in— Variables 控件 中 使 用 set to 模块 给 全 局 变量 重新 赋 
值 , 如 图 4. 13 所 示 。 


global score 
em r zo. EEC 


图 4.13 全 局 变量 的 使 用 和 重新 赋值 


4.1.3 if…then 扩展 模块 


在 程序 设计 中 ,经 常会 遇 到 同时 使 用 多 条 件 进 行 判 断 的 情况 。if…then 模块 可 以 通 
过 扩展 ,实现 更 为 复杂 的 条 件 判断 ,例如 计 …elseif…else 的 三 分 支 结构 ,if*… elseif*… elseif 
«relse 或 if…elseif…elseif…elseif 的 四 分 支 结构 。 

下 面 用 一 个 小 例子 说 明 如 何 使 用 if…then 扩展 模块 。 给 出 一 个 变量 z,z 可 能 的 值 
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RA 1.2 I3. JR x D 1, o z= 1: WR rH 2, bz x25 IIR z OM 3, WR z 一 3; 如 
Re 为 其 他 值 , 则 显示 “不 在 范围 内 ”"。 为 了 实现 这 个 示例 ,应 该 选择 ife elseif elseif 
else 四 分 支 模块 结构 ,如 图 4. 14 所 示 。 

if…then 模块 扩展 是 通过 单 击 if then 模块 左上 方 的 蓝 色 方块 实现 的 ,在 蓝 色 方 块 
被 点 击 后 ,会 在 if…then 模块 下 方 出 现 扩展 结构 ,如 图 4.15 所 示 。 


if 


then set 
= 


else if 
then set 
= 
else if 
then set 
um 


o s 
一 


图 4.14 判断 x 值 的 示例 图 4.15 让 …then 模块 的 扩展 结构 


在 模块 的 扩展 结构 中 ,只 要 将 左 侧 的 可 拼接 部 分 拖 忠 到 右 侧 的 基础 部 分 ,就 可 以 完成 
模块 扩展 。 例 如 ,将 if…then 模块 的 扩展 部 分 else if 直接 拖 忠 到 基础 部 分 if 中 ,就 完成 了 
图 4. 16 左 侧 的 if…then 扩展 模块 ;然后 ,再 将 if…then 模块 的 扩展 部 分 else 拖 电 到 基础 
部 分 if 中 ,拼接 在 else if 下 方 ,就 完成 了 图 4. 16 右 侧 的 if…then 扩展 模块 。 


图 4.16 if--then 扩展 模块 


下 面 再 通过 一 个 小 示例 说 明 如 何 使 用 让 …then 扩展 模块 ,如 图 4. 17 所 示 。 在 这 个 示 
例 中 ,通过 判断 score 的 值 ,确定 成 绩 的 类 型 : score 的 值 在 90 到 100 之 间 , 成 绩 类 型 为 
“优秀 ;在 80 到 90 之 间 ,成 绩 类 型 为 “良好 ;在 70 到 80 之 间 ,成 绩 类 型 为 “中 等 ;在 60 
到 70 之 间 ,成 绩 类 型 为 “及 格 ”; 在 0 到 60 之 间 ,成 绩 类 型 为 “不 及 格 ”。 
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4.17 成绩 判断 示例 


在 程序 设计 过 程 中 ,经 常会 使 用 到 批量 数据 ,例如 电话 号 码 簿 、 购 物 清单 等 ,AI2 提供 
了 “列表 ”用 来 承载 和 处 理 这 类 批量 数据 。 列 表 是 将 数据 按照 特定 顺序 进行 排列 的 一 种 数 
据 结构 。 列 表 中 的 每 一 个 数据 都 有 位 置信 息 , 称 为 索引 ,用 户 可 以 根据 索引 找到 列表 中 与 
之 对 应 的 数据 。 严 格 来 讲 , AI2 所 建立 的 列表 都 是 动态 的 ,也 就 是 说 列表 在 建立 后 ,用 户 
随时 可 以 向 列表 中 添加 或 删除 数据 。 


4.2.1 建立 列表 


要 使 用 列表 ,首先 要 建立 一 个 列表 ,在 Blocks— Built-in— Lists 控件 中 选择 make a 
list 模块 即 可 建立 列表 ,如 图 4. 18 所 示 。 
make a list 模块 用 来 建立 列表 ,如 果 不 在 槽 中 添加 任何 元 素 ,这 时 的 列表 将 只 是 一 个 
空 列表 ,如 图 4.19 所 示 。 
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Æ 4.18 makea list 模块 


is in list? thing 


list 


| 


4.19 SIR 


要 在 make a list 模块 中 添加 数据 ,只 需要 在 槽 中 添加 需要 的 信息 即 可 。 例 如 将 数字 
95.70 和 88 添加 到 make a list 模块 上 ,如 图 4. 20 所 示 ,此 时 列表 中 有 3 个 数据 ,索引 为 1 


可 视 化 开发 Android 应 用 程序 
— tš | ++ X HEX App Inventor 2 (第 2 路 ) 


的 数据 是 95 ,索引 为 2 的 数据 是 70 ,索引 为 3 的 数据 是 88。 需 要 注意 的 是 ,AI2 的 列表 索 
引 是 从 1 开始 的 。 

如 果 需 要 继续 添加 数据 ,只 需要 单 击 make a list 模块 左上 方 的 蓝 色 方块 ,就 可 以 方 
便 地 添加 列表 空 槽 ,如 图 4. 21 所 示 。 


item 


item 


make a list 
item 


图 4.20 列表 数据 填充 4.21 make a list 模块 的 扩展 结构 


为 了 在 后 面 可 以 调用 创建 的 列表 ,一 般 要 将 列表 保存 在 一 个 变量 中 。 这 里 建立 一 个 
全 局 变量 scores, 并 将 刚 建立 的 列表 拼接 在 全 局 变量 scores 上 ,如 图 4. 22 所 示 。 


initialize global(f 


图 4.22 拼接 在 全 局 变量 scores 上 


4.2.2 获取 列表 项 


4.2.1 小 节 在 列表 scores 中 添加 了 3 个 数据 ,下 面 将 介绍 如 何 通过 索引 获取 列表 中 
的 数据 。 

从 列表 中 获取 数据 需要 使 用 select list item 模块 ,获取 路 径 为 Blocks— Built-in > 
Lists>select list item, 如 图 4. 23 所 示 。 

select list item 模块 中 的 参数 槽 有 两 个 ,分 别 是 list 和 index. ling 4.24 所 示 。 档 list 
用 来 拼接 需要 获取 数据 的 列表 变量 , 槽 index 用 来 指定 索引 编号 。 

下 面 通过 一 个 小 示例 来 说 明 如 何 使 用 select list item 模块 。 列 表 scores 中 目前 有 
3 个 数据 96.70 和 88, 这 里 将 使 用 select list item 模块 获取 索引 为 2 的 数据 70。 

如 图 4. 25 所 示 ,首先 将 列表 变量 scores 拼接 在 模 list 上 ,再 将 数字 2 OH TERI index 
上 ,此 时 select list item 模块 将 会 获取 到 索引 号 为 2 的 数据 。 

通过 索引 获取 列表 中 的 数据 时 ,要 注意 的 是 索引 编号 不 能 够 超过 列表 数据 项 的 总 数 。 
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如 果 索 引号 大 于 列表 的 实际 项 目 ,将 会 引发 索引 越界 ”错误 。 如 图 4. 26 所 示 , 尝 试 在 
scores 列表 中 获取 索引 号 为 4 的 数据 ,实际 上 scores 列表 只 有 3 个 数据 ,将 引发 一 个 “ 索 
引 越界 ”错误 。 
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图 4.23 select list item 模块 


select list item li ee Td 


index 


图 4.24 select list item 模块 图 4.25 获取 scores 列表 中 索引 号 为 2 的 数据 


Runtime Error 四 


Select list item: Attempt to get item number 4 of a list of length 3: (95 70 88) 
Note: You will not see another error reported for 5 seconds. 


| Dismiss | 


图 4.26 “索引 越界 "错误 


4.2.3 遍历 列表 


4. 2. 2 小 节 介 绍 了 根据 索引 号 获取 列表 中 某 一 元 素 的 方法 ,但 在 实际 使 用 过 程 中 ,经 
常会 需要 按照 索引 的 顺序 访问 列表 中 的 所 有 数据 ,例如 显示 列表 中 的 所 有 数据 、 在 列表 中 
找到 最 小 的 数据 .累加 列表 中 所 有 的 数据 等 。 

遍历 列表 最 简单 的 方法 是 使 用 Blocks > Built-in Control 控件 中 的 for each in list 
模块 ,如 图 4.27 所 示 。 这 是 一 种 安全 的 遍历 方法 ,在 遍历 过 程 中 索引 号 不 会 超过 列表 所 
拥有 数据 项 的 最 大 值 , 避 免 了 索引 号 越界 导致 的 错误 。 

下 面 用 一 个 累计 成 绩 的 示例 说 明 如 何 使 用 for each in list 模块 。 在 介绍 这 个 小 示例 
前 , 先 来 介绍 如 何 使 用 局 部 变量 。 局 部 变量 和 全 局 变量 是 AI2 提供 的 两 种 变量 定义 方 
式 , 全 局 变量 定义 后 在 所 有 地 方 都 可 以 直接 使 用 ;而 局 部 变量 在 定义 后 ,只 有 在 特定 的 范 
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围 内 可 以 使 用 。 定 义 局 部 变量 的 好 处 是 不 会 产生 变量 名 冲突 ,比如 在 累加 数学 成 绩 时 ,可 
以 定义 一 个 局 部 变量 sum, 用 来 表示 数学 成 绩 的 总 和 ;在 累加 英语 成 绩 时 ,也 可 以 定义 一 
个 同名 的 局 部 变量 sum, 用 来 表示 英语 成 绩 的 总 和 。 这 两 个 局 部 变量 的 名 称 虽然 相同 ,但 
使 用 的 空间 却 不 相同 ,因此 这 两 个 变量 是 不 冲突 的 。 但 如 果 使 用 全 局 变量 ,变量 名 称 是 绝 
对 不 能 相同 的 。 

定义 局 部 变量 有 两 个 模块 ,如 图 4. 28 所 示 , 区 别 在 于 是 否 有 返回 值 。 


D 
p gg 


图 4.27 for each in list 模块 图 4.28 定义 局 部 变量 模块 


累计 成 绩 示 例 中 ,首先 定义 一 个 局 部 变量 sum, 用 于 保存 成 绩 的 累加 值 。 然 后 修改 
for each in list 模块 中 表示 每 次 遍历 结果 的 局 部 变量 name 为 score, 这 个 局 部 变量 会 在 遍 
历 过 程 中 分 别 代表 scores 列表 中 第 一 项 .第 二 项 和 第 三 项 的 值 , 从 而 实现 对 列表 的 遍历 。 
最 后 ,将 要 遍历 的 列表 变量 scores 拼接 在 for each in list JA m AJAN E ,如 图 4. 29 所 示 。 


LJ initialize local to 


in list 


图 4.29 累计 成 绩 的 示例 


4.2.4 添加 删除 列表 项 


列表 中 的 数据 在 程序 运行 过 程 中 是 可 以 动态 添加 和 删除 的 ,下 面 分 别 介绍 列表 项 添 
加 模块 add items to list 和 删除 模块 remove list item, 如 图 4. 30 所 示 ,这 两 个 模块 的 位 置 
在 Built-In>Lists 模块 中 。 


add items to list list Temove list item list 


item index 


图 4.30 列表 项 添加 模块 和 删除 模块 


add items to list 模块 中 有 两 个 参数 槽 , 槽 list 用 来 拼接 目标 列表 , 槽 item 用 来 拼接 
要 添加 到 列表 中 的 数据 。 神 奇 的 “ 蓝 色 方块 "可 以 让 add items to list 模块 具有 向 列表 中 
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一 次 性 添加 多 个 数据 的 功能 ,如 图 4. 31 所 示 。 


add items to list list Ë 


item B 


item $ 


图 4.31 添加 多 个 数据 


若 要 将 数据 60 和 50 添加 到 列表 scores 中 ,首先 将 列表 scores 拼接 在 add items to 
list 模块 的 槽 list 上 ,然后 将 数据 60 和 50 拼接 在 槽 item 上 即 可 ,如 图 4. 32 所 示 。 

从 列表 中 删除 数据 要 使 用 remove list item 模块 , 槽 list 用 来 拼接 要 操作 的 列表 变 
hit MW index 拼接 要 删除 数据 的 索引 位 置 , 如 图 4. 33 所 示 。remove list item 模块 每 次 只 
能 够 删除 1 个 列表 中 的 一 项 数据 。 


add items to list list get : " a 
emove list item list 


item 


item index 


图 4.32 向 动态 列表 中 添加 元 素 图 4.33 remove list item 模块 


此 时 scores 列表 中 目前 有 5 个 数据 ,分 别 是 95、70、88、60 和 50, 如 果 要 从 scores 列 
表 中 删除 最 后 添加 的 数据 “50”, 则 需 将 索引 号 5 拼接 在 槽 index 上 ,如 图 4. 34 所 示 。 
remove list item 模块 被 调用 后 ,scores 列表 中 则 只 有 4 个 数据 ,分 别 是 95、70、88 和 60, 


remove list item list 


index 
图 4.34 删除 scores 列表 中 的 第 5 项 


如 果 用 户 希 望 删除 列表 scores 中 的 数据 60 .但 并 不 知道 数据 60 的 索引 号 ,可 以 使 用 
index in list 模块 ,位 置 在 Blocks>Built-in>Lists 控件 中 。index in list 模块 有 两 个 参数 
H, SRON thing 用 来 拼接 数据 ,参数 槽 list 拼接 列表 ,该 模块 会 返回 数据 在 列表 中 的 索引 
号 ,然后 再 通过 调用 remove list item 模块 删除 需要 删除 的 列表 数据 就 可 以 了 。 图 4. 35 
所 示 即 使 用 index in list 模块 和 remove list item 模块 删除 列表 scores 中 的 数据 60. 
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remove list item list get 


index index in li 


图 4.35 删除 列表 scores 中 的 数据 60 


43 循环 结构 


在 程序 设计 过 程 中 ,循环 是 一 种 经 常 使 用 到 的 结构 ,可 以 用 来 简化 重复 执行 的 动作 。 
在 4.2.3 小节 中 介绍 的 for each in list 模块 就 属于 循环 结构 ,本 节 将 介绍 具有 通用 意义 的 
两 种 循环 结构 , 即 for…each…from 模块 和 while 模块 。 


4.3.1 for…each…from 模块 


for…each…from 模块 位 置 在 Blocks— Built-in— Control 控件 中 。for…each…from 
模块 中 的 局 部 变量 number 表示 每 次 循环 的 值 , 槽 
from 表示 变量 number 在 循环 开始 时 的 值 ,参数 
Hl to 表示 循环 结束 时 的 值 , 参 数 槽 by 表示 每 次 
循环 的 递增 量 。 在 图 4. 36 所 示 的 for…each… 
from 模块 中 ,循环 的 开始 值 是 1 ,结束 值 是 5, 递增 
量 为 1, 在 5 次 循环 中 变量 number 的 取 值 分 别 为 
| 4.5. 图 4.36  for--each--from 模块 

这 里 用 一 个 10 数字 累加 的 示例 说 明 如 何 使 
用 for…each…from 模块 。 在 这 个 示例 中 ,定义 一 个 全 局 变量 sum 作为 累加 结果 ,循环 的 
开始 值 为 1 ,结束 值 为 10 ,递增 量 为 1, 如 图 4.37 Bros. 


e global 


for each from 


4.37 10 数字 累加 示例 (for…each…from 模块 ) 


4.3.2 while 模块 


相对 于 for…each…from Eit. while 模块 更 加 常用 一 些 。while 模块 是 一 种 有 条 件 
循环 结构 ,在 条 件 满足 时 ,循环 过 程 将 持续 进行 ; 当 条 件 无 法 满足 时 , 则 退出 循环 过 程 。 
while 模块 的 结构 如 图 4. 38 所 示 ,参数 槽 test 用 来 拼接 判断 循环 是 否 继续 执行 的 条 
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件 语句 ,参数 槽 do 是 循环 执行 的 动作 部 分 。while 模块 的 位 置 在 Blocks Built-in 
Control 控件 中 。 

while 模块 中 的 循环 部 分 是 否 执行 ,要 根据 test 中 的 条 件 进行 判断 , 当 test 中 的 条 件 
模块 返回 true 时 ,程序 执行 槽 do 中 的 内 容 ; 若 返回 false, 则 不 执行 槽 do 中 的 内 容 , 而 是 
继续 执行 while 模块 后 面 的 程序 模块 。while 模块 的 执行 流程 如 图 4. 39 所 示 。 


图 4.38 while 模块 图 4.39 while 模块 执行 流程 


这 里 还 是 以 10 数字 累加 为 例 说 明 如 何 使 用 while 模块 。 这 个 例子 仍 是 定义 一 个 全 
局 变量 sum 作为 累加 结果 ,定义 一 个 全 局 变量 n 表示 循环 的 当前 值 , 循 环 的 开始 值 为 1， 
结束 值 为 10 ,递增 量 为 1, 如 图 4.40 所 示 。 


initialize global 


图 4.40 10 数字 累加 示例 (while 模块 ) 


在 while 模块 循环 过 程 中 ,每 次 循环 前 都 要 检测 槽 test 的 条 件 是 否 满足 “n 三 10”, 如 
RW ER SON do 的 动作 是 将 变量 n 累加 到 变量 sum 中 ,并 在 每 次 循环 过 程 中 将 变 
量 n 增加 1。 这 样 在 nn 是 1~10 之 间 的 值 时 ,都 满足 条 件 “z 生 10”, 所 以 变量 sum 可 以 获 
取 到 1 一 10 的 累加 值 。 当 等 于 11 时 ,无 法 满足 条 件 “n 三 10”,while 模块 结束 循环 。 


44 函数 


有 一 个 经 典 的 脑筋 急 转 弯 ,可 以 用 来 说 明 什么 是 函数 。 还 记得 把 大 象 放 到 冰箱 里 面 
要 几 个 步骤 吗 ? 第 一 步 是 打开 冰箱 门 ,第 二 步 是 把 大 象 放 进 冰箱 ,第 三 步 是 关上 冰箱 门 。 

那么 ,把 一 个 李 雷 放 到 冰箱 里 面 有 几 步 呢 ? 仍然 是 三 步 ,第 一 步 是 “打开 冰箱 门 ”, 第 
二 步 是 把 李 雷 “ 放 进 冰箱 ”, 第 三 步 是 “关上 冰箱 门 ”。 类 似 的 ,把 韩 梅 梅 放 到 冰箱 里 面 的 步 
又 也 很 容易 就 会 想到 了 。 
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定义 函数 的 好 处 就 是 可 以 避免 重复 编写 代码 工作 。 举 个 例子 说 明 这 个 好 处 ,如 果 要 
把 李 雷 、 韩 梅 梅 、 林 涛 和 露 西 都 放 到 冰箱 里 面 ,那么 “打开 冰箱 门 ” 的 操作 都 是 一 样 的 ,如 果 
每 次 做 这 个 操作 都 要 使 用 一 大 堆 同 样 的 模块 代码 ,是 一 件 很 麻烦 、 低 效率 的 事情 ,使 用 函 
数 可 以 解决 这 个 问题 。 将 “打开 冰箱 门 ”的 操作 定义 成 为 函数 , 称 之 为 “函数 : 打开 冰箱 
门 ”, 那 么 在 每 次 需要 “打开 冰箱 门 ”操作 时 ,就 不 需要 堆砌 这 些 相同 的 模块 代码 了 ,只 需 
引用 “函数 : 打开 冰箱 门 ”就 可 以 实现 相同 的 效果 。 

AI2 提供 了 自 定义 函数 功能 ,允许 用 户 将 实现 一 定 功能 的 模块 进行 封装 ,并 为 其 封装 
后 的 模块 进行 命名 ,这样 就 创建 了 一 个 函数 ,并 可 以 被 其 他 模块 调用 ,实现 了 基本 的 代码 
复 用 。 代 码 复 用 不 仅 降低 了 程序 的 错误 率 , 而 且 提高 了 程序 的 可 维护 性 。 


4.4.1 定义 与 调用 


在 AI2 中 ,定义 函数 的 过 程 与 定义 变量 的 过 程 十 分 相似 。 首 先 在 Blocks > Built-in > 
Procedures 控件 中 找到 定义 函数 的 模块 ,如 图 4. 41 所 示 。 两 个 函数 定义 模块 的 区 别 在 
于 ,有 参数 槽 do 的 函数 模块 没有 返回 值 , 有 参数 槽 result 的 函数 模块 是 有 返回 值 的 。 


图 4.41 两 个 函数 定义 模块 


下 面 尝试 将 10 数字 累加 的 示例 封装 成 函数 SumNuml, 供 其 他 使 用 者 调用 , 先 使 用 
没有 返回 值 的 函数 模块 ,如 图 4. 42 所 示 ,函数 命名 为 SamNuml, 全 局 变量 sum 用 来 保存 
累加 值 。 


图 4.42 10 数字 累加 函数 (无 返回 值 ) 


这 个 设计 函数 并 不 完美 ,因为 在 函数 中 使 用 了 全 局 变量 ,这 样 并 不 是 一 个 良好 的 设计 
习惯 ,容易 在 出 现 错误 时 难以 定位 问题 。 改 良 函 数 SumNuml ,命名 为 SumNum2 ,使 用 局 
部 变量 保存 累加 值 ,并 将 最 终 的 结果 通过 函数 返回 给 调用 者 ,如 图 4. 43 所 示 。 

函数 定义 完成 后 ,怎样 才能 发 挥 它 的 作用 呢 ? 定义 完 成 后 的 函数 只 是 一 个 单独 的 功 
能 模块 ,只 有 在 程序 执行 的 过 程 中 调用 了 这 个 函数 ,该 函数 才能 被 执行 并 发 挥 自 己 的 
功能 。 
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4.43 10 数字 累加 函数 (有 返回 值 ) 


所 有 定义 过 的 函数 都 会 出 现在 Blocks-— Built-in Procedures 控件 中 。 上 面 定义 过 
的 函数 SumNuml 和 SumNum2 也 会 出 现在 这 里 ,如 图 4. 44 Bros ,左边 的 SumNuml FR 
数 调用 模块 是 没有 返回 值 的 ,右边 的 SumNum2 函数 调用 模块 是 具有 返回 值 的 。 


(en Sm | 
4.44 SumNuml 和 SumNum2 函数 的 调用 模块 


下 面 简单 演示 如 何 使 用 函数 。 定 义 一 个 全 局 变量 var, 初 始 值 为 0, 然后 修改 var 的 
值 为 调用 SumNum2 函数 的 返回 值 加 上 10, 如 图 4. 45 所 示 。 


initial 


图 4.45 调用 SumNum 函数 


从 程序 的 执行 顺序 上 来 说 , 当 程 序 运行 到 SumNum2 函数 时 ,会 进入 SumNum2 PA% 
Mk ,执行 完 SumNum2 函数 体 后 ,又 会 跳 回 到 调用 SumNum2 函数 的 位 置 ,继续 执行 下 一 
个 动作 模块 。 


4.4.2 函数 参数 


像 大 部 分 模块 一 样 ,函数 模块 也 有 自己 的 参数 ,可 以 根据 参数 的 不 同 , 产 生 不 同 的 调 
用 结果 。 创 建 函 数 的 目的 是 消除 代码 的 元 余 ,提高 代码 的 效率 ,最 重要 的 是 函数 要 尽量 做 
到 通用 性 好 ,这 就 需要 给 函数 定义 参数 ,使 函数 具有 广泛 性 和 普遍 性 。 

下 面 继续 修改 “10 数字 累加 ”示例 ,使 函数 可 以 自 定义 累加 的 起 止 值 。 如 图 4.46 所 
示 , 函 数 SumNum3 多 了 两 个 参数 start 和 end, 分 别 表示 累加 的 开始 值 和 结束 值 ,这 两 个 
参数 是 从 函数 的 调用 者 传递 过 来 的 。 函 数 体内 部 的 for each from 模块 使 用 这 两 个 参数 
作为 循环 的 起 止 值 , 这 样 从 函数 外 部 传递 过 来 的 参数 就 作用 到 函数 内 部 的 模块 上 了 ,从 而 
实现 了 函数 调用 者 给 出 参数 控制 函数 内 部 循环 次 数 的 效果 。 
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to 
Tesult initialize local 


in 


do | for each 


图 4.46 SumNum3 函数 


在 函数 上 添加 参数 同样 是 使 用 函数 模块 上 的 蓝 色 方块 。 如 图 4.47 所 示 ,只 要 将 参数 
input; x 拖 忠 到 基础 部 分 inputs 中 就 可 以 了 。 


4.47 调用 SumNum 函数 (参数 N 为 50) 


通过 上 述 内 容 不 难 发 现 ,为 函数 增加 参数 可 以 增加 函数 的 通用 性 。 函 数 参 数 的 设 定 
对 于 函数 的 作用 范围 和 适用 性 具有 和 较 大 的 影响 ,所 以 在 函数 的 创建 过 程 中 要 注意 函数 中 
参数 的 设置 问题 。 


CASE 


l. 简 述 程序 设计 中 的 几 种 分 支 和 循环 模块 的 特点 。 
2. 简 述 如 何 实现 列表 的 创建 .添加 和 删除 。 
3. 设计 一 个 可 以 计算 3 个 整数 的 平均 值 的 函数 。 


用 户 界面 是 应 用 程序 开发 的 重要 组 成 部 分 ,决定 了 应 用 程序 是 否 美观 、 易 用 。AI2 使 
用 可 视 化 的 、 所 见 即 所 得 的 方式 来 搭建 应 用 程序 的 界面 部 分 。 通 过 本 章 的 学 习 , 读 者 可 以 
熟悉 界面 设计 中 的 布局 方式 和 常用 控件 。 


。 掌握 界面 布局 的 使 用 方法 
。 了 解 控 件 分 类 和 基本 用 途 
。 掌握 常用 控件 的 使 用 方法 


51 控件 概述 


A12 的 界面 开发 采用 可 视 化 的 方法 ,通过 将 界面 控件 拖 忠 到 界面 编辑 器 内 ,在 预览 区 
中 可 以 直接 生成 界面 的 效果 图 ,这 些 可 以 被 拖 忠 的 界面 元 素 就 是 控件 。 

AI 的 控件 库 中 有 丰富 的 界面 控件 。 控 件 细 分 为 9 个子 类 , 共 51 个 控件 ,控件 的 类 
别 、. 说 明和 数量 如 表 5. 1 所 示 。 


表 5.1 界面 控件 的 类 别 和 数量 


类 3 说 明 数量 类 a 说 明 数量 
User Interface 常用 控件 11 | Social 社交 控件 6 
Layout 屏幕 布局 3 |Storage 存储 控件 3 
Media 媒体 控件 9 |Connectivity 通信 控件 4 
Drawing and Animation | ”动画 控件 3 |LEGO MINIDSTORMS | 乐高 机 器 人 控件 | 7 
Sensors 传感器 控件 5 


常用 控件 (User Interface) 是 界面 开发 过 程 中 使 用 频率 最 高 的 控件 , 像 按 钮 .标签 和 
复 选 框 等 控件 。 屏 幕布 局 (Layout) 是 用 于 设 定 屏幕 中 元 素 的 排列 方式 的 控件 。 媒 体 控 
件 (Media) 类 中 主要 是 用 来 播放 声音 、 视 频 , 以 及 进行 录音 、 录 像 的 控件 。 动 画 控件 
(Drawing and Animation) 类 是 用 来 开发 游戏 和 绘图 程序 的 控件 。 传 感 器 控件 (Sensors) 
类 中 是 与 硬件 设备 相关 的 控件 ,包括 加 速度 传感器 、 位 置 传感器 \ 方 向 传感器 和 进 场 通信 
等 控件 。 社 交 控 件 (Social) 类 中 是 一 些 用 来 与 他 人 交互 的 控件 ,例如 拨号 控件 .短信 控件 、 
选取 联系 人 控件 等 。 存 储 控件 (Storage) 类 包含 了 与 信息 存储 相关 的 控件 ,包括 本 地 数据 
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库 和 网 络 数据 库 控件 等 。 通 信 控 件 (Connectivity) 类 主要 包含 蓝牙 .Web 等 用 于 信息 交 
换 的 控件 。 乐 高 机 器 人 控件 (LEGO MINIDSTORMS) 类 是 乐高 NXT 智慧 型 机 器 人 的 开 
发 控件 。 


52 mEfnm 
在 设计 应 用 程序 时 ,设计 者 往往 需要 仔细 考虑 不 同 控件 在 界面 上 的 布局 和 构图 效果 ， 


而 不 只 是 单纯 把 控件 堆积 在 屏幕 上 。 为 了 能 够 设计 出 相对 美观 的 布局 结构 ,AI2 提供 了 
Layout( 屏 幕布 局 ) 控 件 , 支 持 水 平 布局 垂直 布局 和 


表格 布局 ,如 图 5.1 所 示 。 Layout 
这 些 布局 可 以 按照 一 定 顺序 或 者 相对 关系 ,排列 | 国 HorizontalArangement @ 


布局 内 部 的 控件 。 布 局 本 身 在 界面 上 没有 任何 显示 ， | 图 Tablearangement " 
也 不 具备 事件 响应 功能 ,因此 布局 并 不 能 响应 单 击 或 
拖 动 等 操作 。 即 便 如 此 ,布局 仍然 是 界面 设计 中 不 可 
缺少 的 组 成 部 分 ,是 提升 应 用 程序 视觉 效果 和 美观 程 
度 的 关键 所 在 。 


5.2.1 水 平 布 局 


Horizontal Arrangement( 水 平 布局 ) 是 一 种 重要 的 界面 布局 ,也 是 经 常 使 用 的 界面 
布局 。 在 水 平 布局 中 ,所 有 界面 控件 都 在 水 平方 向 上 按照 顺序 进行 排列 ,也 就 是 说 ,每 列 
仅 包含 一 个 控件 。 

如 图 5. 2 所 示 ,上 方 是 界面 编辑 器 中 预览 区 的 效果 图 ,下 方 是 在 手机 上 的 运行 结果 
图 。 在 效果 图 中 ,可 以 很 容易 找到 水 平 布局 的 位 置 ,而 在 运行 结果 图 中 ,水 平 布局 的 边框 
被 隐藏 了 。 

将 水 平 布局 拖 电 到 界面 编辑 器 后 ,会 在 界面 上 形成 一 个 正方 形 区 域 ,如 图 5. 3 所 示 。 


[B] verticalArrangement @ 


图 5.1 可 视 化 控件 布局 的 3 种 方式 


Screen1 


Screen1 


图 5.2 水 平 布局 在 界面 编辑 器 和 手机 运行 时 的 不 同 效 果 图 5.3 空 的 水 平 布局 


将 第 一 个 控件 拖 忠 到 这 个 正方 形 的 区 域 中 ,这 个 正方 形 的 区 域 会 变 成 长 方形 ,以 后 所 
有 加 入 的 控件 都 会 按照 水 平方 向 排 布 ,如 图 5.4 所 示 。 需 要 注意 的 是 ,不 要 让 水 平 布 局 中 
控件 的 总 尺寸 超出 屏幕 的 显示 范围 。 


水 平 布局 只 有 AlignHorizontal、AlignVertical Visible, Width 和 Height 五 个 属性 ， 
如 图 5.5 所 示 。Visible 属性 设置 水 平 布局 中 的 所 有 控件 是 否 可 见 , 如果 将 其 设置 为 
false, 则 水 平 布局 中 的 所 有 控件 都 不 可 见 。AlignHorizontal 和 AlignVertical 设置 布局 中 
控件 的 排 布 方式 。 


Screen 


5.4 向 水 平 布局 添加 控件 


Properties 


HorizontalArrangement1 


AlignHorizontal 
Left "| 


AlignVertical 
Top 3 


Visible 


| showing " 


width 
Fill parent 


Height 


Automatic... 


5.5 水 平 布局 的 属性 


尝试 改变 一 下 水 平 布局 的 AlignHorizontal 属性 ,分 别 设置 为 Left, Center 和 Right, 
即 水 平 布 局 内 的 控件 排 布 方式 分 别 为 左 对 齐 、 居 中 和 右 对 齐 ,效果 如 图 5.6 所 示 。 


RA. 提交 | | 放弃 


Screen1 


图 5.6 水 平 布局 的 AlignHorizontal 属性 效果 
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5.2.2 垂直 布局 


VerticalArrangement( 垂 直 布 局 ) 中 ,所 有 界面 控件 都 在 垂直 方向 按照 顺序 进行 排 
列 ,也 就 是 说 ,每 行 仅 包含 一 个 界面 控件 ,如 图 5.7 所 示 。 垂 直 布 局 的 属性 与 水 平 布局 完 
全 相同 。 


Screen1 


图 5.7 垂直 布局 
垂直 布局 与 水 平 布局 艇 套 是 经 常 使 用 的 技巧 ,可 以 实现 类 似 图 5. 8 所 示 的 效果 。 


5.8 ”垂直 布局 嵌 套 水 平 布局 


5.2.3 表格 布局 


TableArrangement( 表 格 布局 ) 也 是 一 种 常用 的 界面 布局 , 它 将 屏幕 划分 为 表格 , 通 
过 指定 Rows( 行 ) 和 Columns( 列 ) 属 性 控制 格子 的 数量 。 图 5. 9 所 示 是 一 个 3X3 的 表格 
布局 ,每 个 格子 中 放置 一 个 按钮 控件 。 表 格 布局 会 根据 控件 的 大 小 自动 修改 表格 的 大 小 ， 
这 是 一 个 方便 ,实用 的 功能 。 

Rows( 行 ) 和 Columns( 列 ) 是 表格 布局 的 专 有 属性 ,表示 表格 的 行 数 和 列 数 ,可 以 在 
界面 编辑 器 的 属性 区 内 进行 更 改 , 如 图 5. 10 所 示 。 


Screen] 
TableArrangement1 
Buttonl Button2 Button3 S^ - 
Columns. 
Button4 || Buttonb | Button6 FEEDS | 
Button7 Button8 Button9 Rows 
3 J 


图 5.9 表格 布局 图 5.10 表格 布局 的 属性 
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当然 ,在 表格 布局 中 也 可 以 放置 其 他 布局 , 像 水 平 布 局 或 垂直 布局 ,实现 布局 的 嵌 套 。 
图 5.11 即 实现 了 一 个 2X2 的 表格 布局 ,在 左上 和 右 下 的 格子 中 典 套 了 垂直 布局 ;在 右上 
和 左下 的 格子 中 嵌 套 了 水 平 布局 。 


Screen1 


= | | 
Text for CheckBox1 
Button3 Button4 


国 Text for CheckBox2 


国 Text for CheckBox3 


Button5 Button6 
一 | 目 Text for CheckBox4 


图 5.11 表格 布局 的 其 套 
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常用 控件 是 使 用 频率 较 高 的 一 些 控件 的 集合 ,这 些 控件 包括 Button (按钮 )、 
CheckBox( 复 选 框 )、Clock (时 钟 )、Image (图 片 )、Label( 标 签 )、ListPiker (选项 列表 )、 
Notifier Gi Al) , PasswordTextBox C lid HE ) , TextBox C XC Æ HE) M WebViewer( 网 页 浏 


览 器 ) o 
5.3.1 按钮 .标签 和 图 像 
1. 按钮 


Button( 按 钮 ) 是 界面 上 最 基本 的 组 件 ,主要 提供 单 击 式 的 触发 操作 ,如 图 5. 12 所 示 。 
通过 设置 按钮 的 事件 和 状态 ,可 以 实现 基本 的 交互 
功能 。 确定 取消 

常用 控件 中 第 一 项 就 是 按钮 ,可 见 按钮 在 界面 开 
发 上 的 重要 程度 。 如 图 5. 13 Pos Bon etes c LEER ER Case 
有 一 个 问号 , 单 击 问号 可 以 获取 到 控件 的 使 用 说 明 。 

改变 按钮 的 形状 是 通过 修改 按钮 属性 来 实现 的 ， 图 5.12 各 种 按钮 
按钮 有 大 量 属性 供用 户 使 用 ,通过 修改 这 些 属性 ,按钮 
将 呈现 不 同 的 颜色 和 形状 ,显示 不 同 的 内 容 ,拥有 不 同 的 字体 、 字 号 等 。 只 要 在 预览 区 选 
中 按钮 ,然后 在 属性 区 就 可 修改 按钮 的 属性 。 图 5. 14 所 示 是 按钮 属性 的 编辑 栏 ,按钮 属 
性 的 含义 如 表 5. 2 所 示 。 

在 按钮 的 属性 中 ,有些 属性 在 其 他 界面 控件 中 也 经 常 出 现 , 像 Enabled, 
TextAlignment, Width 和 Height 等 。 下 面 先 对 这 些 经 常 使 用 的 属性 进行 介绍 。 

Enabled 属性 标识 控件 是 否 可 用 。 将 控件 的 Enabled 属性 设置 为 不 可 用 ,界面 上 的 控 


^ 
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User Interface 


国 Button @ 
CheckBox @ 
fJ Clock [o] 
EE Image o 
[A] Label o 
Bj ListPicker o 
Á Notifier o 
[**] PasswordTextBox o 
Button with the ability to detect clicks. 
NB Slider o Many aspects of its appearance can be 
changed, as well as whether it is clickable 
0 TextBox © (Enabled), can be changed in the Designer 
WebViewer o or in the Blocks Editor. 


More information 


图 5.13 常用 控件 和 按钮 控件 说 明 


|| Shape 
rounded — *| 
Button1 
ShowFeedback 
BackgroundColor LJ 
|l Defaut Text 
| Enattea | | Textfor Buttont 
LJ TextAlignment | 
| FontBold center "| 
e 
E ji TextColor 
| si Ë: B pets 
| Fontsize | >e 
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| | default "| ] 
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se J 


图 5.14 按钮 属性 的 编辑 栏 
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R52 按钮 属性 

属 性 说 明 
Background Color 设置 按钮 的 背景 色 
Enabled 设置 按钮 是 否 可 用 
FontBold 设置 字体 加 粗 
Fontltalic 设置 字体 倾斜 
FontSize 设置 字体 大 小 
FontTypeface 设置 字体 类 型 
Image 设置 按钮 的 背景 图 案 
Shape 设置 按钮 的 形状 ,如 圆 角 按钮 矩形 按钮 等 
ShowFeedback 为 有 背景 图 片 的 按钮 提供 视觉 反馈 
Text 设置 按钮 上 显示 的 文字 ,如 果 清 空 , 则 不 在 按钮 上 显示 任何 文字 
TextAlignment 设置 按钮 上 文字 的 对 齐 方式 
TextColor 设置 文本 的 颜色 
Visible 设置 按钮 是 否 可 见 
Width 设置 按钮 的 宽度 
Height 设置 按钮 的 高 度 


件 会 变 为 灰色 , 且 不 接受 任何 用 户 操作 。 如 图 5. 15 所 示 ,Buttonl 的 Enabled 属性 为 可 
用 ,而 Button2 的 Enabled 属性 为 不 可 用 。 

TextAlignment 属性 可 以 设置 文字 的 对 齐 方式 ,支持 左 对 齐 OSEE HUS rp 3 种 对 齐 
方式 。 如 图 5. 16 所 示 ,3 个 按钮 ,从 上 到 下 分 别 是 左 对 齐 、 居 中 和 右 对 齐 显示 文字 。 


Text for Button1 
Text for Button2 Text for Button3 


5.15 按钮 的 Enabled 属性 5.16 按钮 的 TextAlignment 属性 


Width( 宽 度 ) 和 Height( 高 度 ) 属 性 也 是 每 个 控件 必 有 的 属性 ,控制 着 控件 在 界面 上 
显示 的 宽度 和 高 度 ,支持 Automatic. K zh) Fill Parent( 填 充 ) 和 pixels( 固 定 尺 寸 )3 种 选 
择 。 如 图 5.17 所 示 ,Buttonl 的 宽度 是 自动 模式 ,因此 按钮 的 宽度 刚好 与 文字 匹配 ; 
Button2 的 宽度 是 填充 模式 ,因此 按钮 的 宽度 达到 上 一 层 控件 ( 父 控件 ) 所 允许 的 最 大 值 ; 
Button3 的 宽度 是 固定 尺寸 模式 ,尺寸 为 280 像素 。 

Shape 属性 可 以 控制 按钮 的 外 部 形状 ,目前 支持 圆 角 形 、 和 矩形 和 椭圆 形 , 如 图 5. 18 
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Text for Buttonl 


Text for Button2 


Text for Eutton3 


图 5.17 


按钮 的 Width( 宽 度 ) 属 性 


按钮 支持 的 事件 有 Click( 单 击 事件 ) 
件 ) 和 LostFocus( 失 去 焦点 事件 ) ,如 图 5. 19 所 示 。 


bs Button! 区 wu 
do 


LE Buttonl * BKo Agt s 


do 


图 5.19 


| Text for Buttonl J 
l e 


Text for Button2 


Text for Button3 ° 
EU mer LU, 


5.18 按钮 的 Shape 属性 


.LongClick (K f F fF) , GetFocus CIRC fl AE 


LE Button] í 


do 


do 


按钮 支持 的 事件 


. GotFocus 


LUC Burton] ~ BP atin] 


手指 按 下 后 立即 抬 起 才 会 产生 单 击 事件 ,否则 会 产生 长 按 事 件 。 如 果 长 时 间 按 在 按 
钮 上 ,即使 没有 抬 起 手指 ,也 会 引发 长 按 事件 。 获 取 焦 点 事件 和 失去 焦点 事件 分 别 在 按钮 
获取 到 焦点 和 失去 焦点 时 产生 。 


2. 标签 


Label( 标 签 ) 主 要 起 到 文字 显示 的 作用 ,但 标签 不 允许 用 户 进行 输入 操作 ,只 能 够 显 


示 文 字 信息 ,如 图 5. 20 所 示 。 标 签 只 
有 事件 ,因此 标签 不 支持 单 击 、 长 按 或 焦点 切换 


等 操作 。 


有 属性 , 没 这 是 默认 字体 的 标签 
这 是 带 背景 颜色 的 标签 
标签 与 按钮 有 部 分 属性 是 相同 的 ,这 里 不 再 这 是 修改 过 字体 属性 的 标签 


重复 介绍 ,标签 支持 的 其 他 属性 和 说 明 如 表 5. 3 图 5.20 标签 控件 
所 示 。 
表 5.3 标签 的 属性 
属 性 说 明 md 说 B 

Background Color 设置 标签 背景 色 TextAlignment | 设置 标签 内 文字 的 对 齐 方式 
FontBold 设置 字体 加 粗 TextColor 设置 文本 的 颜色 
FontItalic 设置 字体 倾斜 Visible 设置 标签 是 否 可 见 
FontSize 设置 字体 大 小 Width 设置 标签 的 宽度 
FontTypeface 设置 字体 类 型 Height 设置 标签 的 高 度 
Text 设置 标签 栏 内 显示 的 文字 


3. 图 像 
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Image( 图 像 ) 控 件 用 于 在 界面 上 显示 各 种 图 像 文件 ,也 不 支持 事件 ,所 支持 的 属性 如 
表 5.4 所 示 。 图 像 控件 虽然 功能 单一 ,但 由 于 属性 简单 ,易于 使 用 ,因此 在 应 用 开发 过 程 
中 会 经 常会 使 用 到 。 图 5. 21 所 示 即 是 一 个 加 载 了 图 片 的 图 像 控件 。 


表 5.4 图 像 属性 及 说 明 


属性 说 

Picture 选择 显示 的 图 像 

Visible 设置 图 像 是 否 可 见 

Width 设置 图 像 的 宽度 

Height 设置 图 像 的 高 度 
4. 综合 示例 


22 


图 5.21 图 像 控件 示例 


下 述 FourSeasons 示例 综合 运用 了 按钮 .标签 和 图 像 控件 ,应 用 的 界面 效果 如 图 5. 22 


id 
FourSeasons 


四 季 更 蔡 


所 示 。 下 面 通过 这 个 示例 向 读者 展示 如 何 综合 
使 用 这 些 控 件 设计 一 个 简单 的 应 用 。 

在 FourSeasons 示例 中 ,通过 单 击 下 方 标 
有 “春天 ”、“ 夏 天 ”“ 秋 天 ”和 “冬天 ”4 个 按钮 ， 
可 以 切换 界面 上 方 表示 季节 的 图 片 和 文字 

如 图 5.23 所 示 , FourSeasons 示例 的 界面 
简单 明了 ,最 上 方 显 示 “ 四 季 更 替 ” 文 本 的 是 一 
个 标签 ,标签 的 名 称 为 Title。 下 方 是 显示 季节 
的 图 像 控件 ,名 称 为 Picture。 再 下 方 是 一 个 标 
签 控件 ,名 称 为 Text, 用 来 显示 用 户 单 击 按钮 
后 的 提示 信息 。 最 下 方 是 4 个 按钮 控件 ,分 别 
命名 为 春天 、 夏 天 、 秋 天 和 冬天 。 

图 像 控件 使 用 的 图 片 , 要 预先 通过 
“Upload File” 按 钮 加 载 到 工程 中 ,“ Upload 
File” 按 钮 在 界面 编辑 器 的 资源 区 (Media) 中 ,如 
图 5. 24 所 示 。 

FourSeasons 示例 的 逻辑 非常 简单 :“ 按 不 
同 的 按钮 ,显示 不 同 的 图 片 和 不 同 颜色 的 文本 
信息 ”, 这 样 需要 为 每 个 按钮 添加 一 个 单 击 事 


冬天 


图 5.22 FourSeasons 示例 运行 界面 


TF ,并 在 单 击 事件 中 修改 显示 的 图 片 ,以 及 显示 文字 的 颜色 。FourSeasons 示例 的 全 部 逻 


辑 如 图 5. 25 所 示 。 
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图 $.23  FourSeasons 示例 的 界面 设计 图 


Upload File ... 


未 选择 文件 


autumn jpg 
spring jpg 
summer jpg 
winter jpg 
Upload File … | 


图 5.24 将 图 片 加 载 到 工程 中 


when «Click 
d 


图 5.25 FourSeasons 示例 的 全 部 逻辑 
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5.3.2 文本 框 复 选 框 和 密码 框 
1. 文本 框 


TextBox( 文 本 框 ) 是 一 种 供用 户 进 行 输入 文字 操作 的 控件 。 虽 然 文本 框 可 以 显示 文 
字 信 息 ,但 其 主要 功能 还 是 为 用 户 提 供 输入 信息 的 区 域 ,比如 登录 框 .搜索 栏 或 编辑 文字 
的 写字 板 等 。 文 本 框 的 使 用 范围 非常 广泛 ,是 基本 的 信息 输入 控件 之 一 ,是 很 多 应 用 程序 
中 不 可 或 缺 的 组 成 部 分 。 

当 文 本 框 的 内 容 为 空 时 ,会 自动 在 文本 框 中 以 灰色 文字 显示 提示 信息 (Hint)。 提 示 
信息 可 以 在 文本 框 的 Hint 属性 中 进行 设置 ,如 图 5. 26(a) 所 示 , 文 本 框 显示 了 “Hint for 
TextBox1” 的 提示 信息 。 


Hint for TextBox1 


(a) 单行 文本 框 
这 是 一 个 可 以 显示 多 行文 本 的 文本 框 ， 这 是 一 个 
可 以 显示 多 行文 本 的 文本 框 ， 这 是 一 个 可 以 显示 
多 行文 本 的 文本 框 ， 这 是 一 个 可 以 显示 多 行文 本 
的 文本 框 ， 这 是 一 个 可 以 显示 多 行文 本 的 文本 
框 ， 这 是 一 个 可 以 显示 多 行文 本 的 文本 杠 

(b) 多 行文 杰 秆 

图 5.26 文本 框 


MultiLine 属性 可 以 控制 文本 框 显示 单行 文本 或 多 行文 本 ,在 图 5. 26(a) 中 ,文本 框 
的 MultiLine 属性 没有 被 设置 ,无论 用 户 输入 多 少 信息 ,文本 框 会 一 直 保持 单行 的 状态 ; 
在 图 5. 26(b) 中 ,文本 框 的 MultiLine 属性 已 经 被 设置 ,因此 在 户 输入 较 多 信息 时 ,文本 框 
会 自动 变 为 多 行 显示 模式 。NumbersOnly 属性 控制 了 文本 框 中 可 输入 的 信息 的 类 型 ,如 
果 该 属性 被 设置 为 true, 文 本 框 将 只 接受 数字 ,不 接受 用 户 输入 其 他 字符 。 

文本 框 控件 的 全 部 属性 如 表 5. 5 所 示 。 


表 5.5 文本 框 属性 及 说 明 


B 性 说 明 
Background Color 设置 文本 框 的 背景 色 ,默认 为 白色 
Enabled 设置 文本 框 是 否 可 用 
FontBold 设置 字体 加 粗 
Fontltalic 设置 字体 倾斜 
FontSize 设置 字体 大 小 
FontTypeface 设置 字体 类 型 
Hint 设置 文本 框 的 提示 信息 
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续 表 
属 性 说 明 
MultiLine 设置 是 否 支 持 多 行 显示 
NumbersOnly 设置 是 否 只 允许 输入 数字 
Text 设置 文本 框 上 默认 显示 的 文字 内 容 
TextAlignment 设置 按钮 上 文字 的 对 齐 方 式 
TextColor 设置 文本 的 颜色 
Visible 设置 文本 框 是 否 可 见 
Width 设置 文本 框 的 宽度 
Height 设置 文本 框 的 高 度 


文本 框 支持 GotFocus (获取 焦点 事件 ) 和 LostFocus (失去 焦点 事件 ), 如 图 5. 27 
所 示 。 


WES GotFocus CES IosiFocs 


图 5.27 文本 框 控件 事件 


文本 框 支持 的 方法 只 有 HideKeyboard, 如 图 5. 28 所 示 。 该 方法 用 来 隐藏 软 键盘 , 主 
要 用 在 设置 了 MultiLine 属性 的 多 行文 本 框 ,因为 单行 文本 框 只 要 按 软 键盘 上 的 完成 
(Done) 键 或 者 手机 上 的 回 退 键 就 会 自动 隐藏 软 键盘 。 


2. 复 选 框 


CheckBox( 复 选 框 ) 是 可 以 同时 选中 多 项 的 选项 框 ,供用 户 在 不 同 选项 间 进 行 多 项 选 
择 时 使 用 ,在 程序 当中 起 到 条 件 识别 的 作用 ,如 图 5. 29 所 示 。 


[] Text for CheckBox1 
图 5.28 文本 框 的 HideKeyboard 方法 图 5.29 复 选 框 


Checked 属性 是 复 选 框 的 标志 性 属性 ,表示 复 选 框 是 否 被 选中 。 复 选 框 的 高 度 
(Height) 和 宽度 (Width) 属 性 可 以 设置 复 选 框 文字 所 占用 的 空间 。 复 选 框 一 般 多 个 联合 
起 来 使 用 ,作为 多 个 条 件 的 组 合 判 断 依据 ,不 过 也 可 以 单独 使 用 。 复 选 框 的 全 部 属性 及 说 
明 如 表 5.6 所 示 。 

复 选 框 除 了 支持 GotFocus( 获 取 焦 点 事件 ) 和 LostFocus( 失 去 焦点 事件 ) 以 外 ,还 支 
持 Changed( 选 项 更 改 ) 事 件 。 更 改 事件 在 复 选 框 的 选择 状态 发 生 改变 时 触发 ,如 图 5. 30 
所 示 。 
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表 5.6 复 选 框 的 属性 及 说 明 


属 性 说 明 
Background Color 设置 复 选 框 的 背景 色 
Checked 设置 复 选 框 默认 状态 是 否 被 选中 
Enabled 设置 复 选 框 是 否 可 用 
FontBold 设置 复 选 框 字体 加 粗 
Fontltalic 设置 复 选 框 字体 倾斜 
FontSize 设置 复 选 框 字体 大 小 
FontTypeface 设置 复 选 框 字体 类 型 
Text 设置 复 选 框 的 文字 注释 
TextColor 设置 文本 的 颜色 
Visible 设置 复 选 框 是 否 可 见 
Width 设置 复 选 框 的 宽度 
Height 设置 复 选 框 的 高 度 
3. 密码 框 
PasswordTextBox( 密 码 框 ) 是 一 种 特殊 的 文本 框 ,一 般 用 于 输入 密码 ,可 以 自动 屏蔽 
用 户 的 输入 内 容 。 


如 图 5. 31 所 示 , 上 图 的 密码 框 是 在 输入 内 容 为 空 时 显示 的 提示 信息 ,下 图 的 密码 框 是 
用 户 输入 了 密码 信息 ,屏蔽 处 理 后 显示 为 多 个 星 号 或 圆 点 。 密 码 框 的 属性 如 表 5.7 所 示 。 


图 5.30 复 选 框 控 事件 图 5.31 密码 框 
表 5.7 密码 框 的 属性 及 说 明 
属 人 性 说 明 B 人 性 说 明 
Background Color 设置 密码 框 的 背景 色 Text 设置 密码 框 里 显示 的 文字 
Enabled 设置 密码 框 是 否 可 用 TextAlignment | 设置 密码 框 上 文字 的 对 齐 方式 
FontBold 设置 密码 框 字体 加 粗 TextColor 设置 文本 的 颜色 
Fontltalic 设置 密码 框 字体 倾斜 Visible 设置 密码 框 是 否 可 见 
FontSize 设置 密码 框 字体 大 小 Width 设置 密码 框 的 宽度 
FontTypeface 设置 密码 框 字体 类 型 Height 设置 密码 框 的 高 度 
Hint 设置 密码 框 的 提示 信息 
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密码 框 也 仅 支 持 GetFocus( 获 取 焦 点 事件 ) 和 LostFocus( 失 去 焦点 事件 ) ,如 图 5. 32 
所 示 o 
when .GotFocus DUE PasswordTextBoxl ~ BSES gaT 
do do 


图 5.32 密码 框 的 事件 


4. 综合 示例 


密码 框 , 文 本 框 和 复 选 框 是 制作 登录 界面 的 必 备 元 素 , 下 面 以 Login 示例 为 例 ,介绍 
如 何 使 用 这 些 基本 的 界面 控件 。 

Login 示例 的 运行 界面 如 图 5. 33 所 示 , 用 户 在 “输入 用 户 名 "文本 框 中 输入 用 户 名 ,在 
“输入 密码 "密码 框 中 输入 密码 , 单 击 “ 登 录 " 按 钮 就 可 以 完成 登录 。 复 选 框 用 来 控制 是 否 显 
示 提 示 信 息 。Login 示例 中 只 有 一 组 正确 的 用 户 名 和 密码 ,用 户 名 是 user, 密 码 是 123456。 
如 果 用 户 输入 正确 ,并 成 功 登 录 , 屏 莫 上 方 的 文本 框 将 显示 “用 户 登录 成 功 ” 提 示 文本 ;如 果 
没有 输入 正确 的 用 户 名 和 密码 ,屏幕 上 方 的 文本 框 将 显示 “用 户 登 录 失 败 " 提 示 文 本 。 


Login 


请 输入 用 户 名 和 密码 


输入 用 户 名 
输入 密码 


登录 
isu. a zmi 


显示 登录 提示 信息 


用 户 名 : user , 密码 : 123456 


图 5.33 Login 示例 运行 界面 


在 Login 示例 的 界面 设计 器 上 修改 模块 构件 区 (Components) 中 的 控件 名 称 , 应 尽量 
使 控件 名 称 具 有 一 定 的 含义 ,这 样 便于 在 模块 编辑 器 中 找到 需要 目标 模块 的 事件 和 属性 ， 
如 图 5. 34 所 示 。 

Login 示例 的 逻辑 部 分 主要 响应 两 个 事件 ,一 个 是 “登录 ”按钮 的 单 击 事件 ,如 图 5. 35 
所 示 ; 另 一 个 是 “显示 登录 提示 信息 ” 复 选 框 的 选项 更 改 事件 ,如 图 5. 36 所 示 。 

用 户 单 击 “ 登 录 ” 按 钮 后 ,首先 判断 文本 框 IDTestBox 中 的 文本 是 否 为 “user” 以 及 文 
本 框 PassTextBox 中 的 文本 是 否 为 "123456”, 这 两 个 判断 是 用 来 确定 用 户 名 和 密码 是 否 
与 预 设 值 相同 。 如 果 用 户 名 和 密码 正确 ,会 在 InfoDisplay 显示 信息 “用 户 登 录 成 功 ”, 否 
则 显示 信息 用户 登 录 失败 ”。 
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i x Components 0000 
E Display hidden components in Viewer © screen 
[AJ infoDisplay 
Login IJ iprextBox 
请 输入 用 户 名 和 密码 yes 
国 Lognauton 
Bogen 
Ss Hintinfo 
登录 
回 显示 登录 提示 信息 


用 户 名 : user, EB: 123456 


Rename Delete 


5.34 Login 示例 的 界面 设计 图 


when c 
de if 


图 5.35 “登录 ”按钮 的 单 击 事件 


vhen (ETE Changed 
和 [LoginHint + Ë == 


to 


5.36 “显示 登录 提示 信息 ” 复 选 框 的 选项 更 改 事件 


在 复 选 框 的 选项 更 改 事件 中 ,首先 判断 复 选 框 是 否 被 选中 ,如 果 被 选中 ,将 HintInfo 
控件 的 可 见 (Visible) 属 性 设 为 真 ,显示 登录 提示 信息 ;反之 将 HintInfo 控件 的 可 见 属 性 
设 为 假 ,将 登录 提示 信息 隐藏 起 来 。 


5.3.3 选项 列表 
ListPicker( 选 项 列表 ) 是 从 列表 的 多 个 项 中 选取 某 一 项 的 控件 ,适合 多 选 一 的 情况 。 
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列表 选项 被 放置 在 界面 上 ,形状 如 一 般 的 按钮 ,如 图 5. 37 所 示 , 单 击 后 会 出 现 黑色 背景 的 
列表 项 供 选 择 。 单 击 列表 中 的 某 一 选项 后 ,黑色 背景 的 列表 项 界面 会 消失 ,返回 按钮 
界面 。 

E 


Text for ListPicker1 


5.37 列表 选项 


选项 列表 中 显示 的 列表 项 , 既 可 以 在 界面 编辑 器 中 定义 ,也 可 在 模块 编辑 器 中 进行 
定义 。 

例如 在 界面 编辑 器 中 修改 选项 列表 的 ElementsFromString 属性 ,将 要 显示 的 列表 用 
逗号 拼接 成 一 个 完整 的 字符 串 , 例 如 “100， š 
500,1000,2000”, 效 果 如 图 5.38 所 示 。 ElementsFromStri ng. 

在 模块 编辑 器 中 ,直接 修改 列表 的 | 100,500,1000,2000 
ElementsFromString 属性 ,或 者 将 列表 拼接 在 | 
列表 的 Elements 属性 上 ,可 以 实现 相同 的 效 5.38 选项 列表 的 ElementsFromString 
果 , 如 图 5. 39 所 示 。 属性 


Prizpen "NINE 100, 500, 1000. 2000 R 


DM ListPickerl - Ë LE ON make a list 


图 5.39 ElementsFromString 和 Elements 属性 


列表 选项 的 属性 中 ,以 往常 见 的 一 些 属性 这 里 不 再 袭 述 , 只 介绍 列表 选项 的 一 些 专 有 
属性 ,如 表 5.8 所 示 。 
属性 ShowFilterBar 是 用 来 显示 列表 项 过 滤 文 本 框 的 ,这 个 过 滤 文 本 框 显 示 在 列表 


项 的 上 方 , 可 以 根据 用 户 的 输入 动态 修改 所 显示 的 列表 项 ,使 之 符合 用 户 的 过 滤 要 求 。 属 
性 Title 是 列表 的 标题 ,显示 在 列表 项 的 最 上 方 。 如 图 5.40 所 示 , 即 属性 ShowFilterBar 
被 设置 ,属性 Title 被 设置 为 “数字 选择 区 ”的 效果 。 


earch list... 
100 
表 5.8 列表 选项 的 专 有 属性 及 说 明 500 
属 性 说 明 
Selection 被 选中 的 列表 项 
ElementsFromString 字符 串 方式 的 列表 项 
ShowFilterBar 显示 过 滤 文本 框 
5.40 ShowFilterBar 和 Title 属性 
选项 列表 支持 的 事件 有 BeforePicking( 选 前 操作 事件 )、AfterPicking( 选 后 操作 事 


件 ) .GetFocus( 获 取 焦 点 事件 ) 和 LostFocus( 失 去 焦点 事件 )。 其 中 , 选 前 事件 发 生 
于 单 击 选项 列表 的 按钮 后 ,列表 项 页 面 弹 出 之 前 ,一般 用 于 处 理 触 发 选项 列表 之 后 的 连带 
操作 。 选 后 操作 事件 是 在 选中 列表 项 后 发 生 的 事件 ,用 于 处 理 用 户 做 出 的 选择 ,这 是 选项 
列表 中 最 常用 的 事件 。 这 两 个 事件 如 图 5. 41 所 示 。 


Mt ListPickerl + :S729 0. $514 Mt ListPickerl + Bvar2ugto $04 
do do 


5.41 选项 列表 的 BeforePicking 和 AfterPicking 事件 


选项 列表 支持 Open 方法 ,如 图 5. 42 所 示 。 在 该 方法 被 调用 时 ,选项 列表 的 列表 项 
被 打开 ,效果 等 同 于 用 户 直接 单 击 选项 列表 的 按钮 。 


(XEM ListPickerl ~ BUS 


图 5.42 选项 列表 的 Open 方法 


5.3.4 时 钟 控件 

Clock( 时 钟 ) 是 非 可 视 化 组 件 , 可 以 获取 当前 时 间 ,格式 化 输出 时 间 , 对 时 间 进 行 运 
算 ,还 可 以 在 固定 的 时 间 间 隔 触 发 事件 。 

获取 当前 时 间 可 以 使 用 时 钟 控件 的 Now 方法 ,如 图 5. 43 所 示 ,可 以 获取 当前 时 间 点 


可 视 化 开发 Android 应 用 程序 
— t | ++ X HEX App Inventor 2 (È 274) 


的 实例 (Instant) 。 

如 果 将 时 钟 的 Now 方法 的 返回 结果 直接 拼接 在 Label( 标 签 ) 上 进行 显示 ,显示 的 结 
果 将 如 图 5. 44 所 示 。 用 户 无 法 直接 使 用 这 样 的 显示 结果 ,虽然 包含 了 所 有 时 间 数 据 , 但 
格式 看 起 来 让 人 匪夷所思 ,解决 的 方法 就 是 使 用 时 钟 的 格式 化 输出 的 方法 。 


java.util 
GregorianCalendar[time-1395753680222,areField 
SSet-true,lenient-true,zone-Asia/Shanghai, 
firstDayOfWeek- 1,minimalDaysInFirstWeek-4,ERA 
FL YEAR-2014,MONTH-2,WEEK OF. YEAR-13,WEI 
K.OF MONTH:-5,DAY OF MONTH-25,DAY OF. YE 
AR-84,DAY OF WEEK-3,DAY OF. WEEK IN. MONT 
H2z4,AM PMz1,HOUR-9,HOUR OF. DAY-21,MINUT 
E-21,SECOND-20,MILLISECOND*222,ZONE. OFFS 
ET-28800000,DST. OFFSET-0] 


图 5.43 当前 时 间 点 图 5.44 Now 方法 的 输出 结果 


时 钟 有 3 种 日 期 的 格式 化 输出 方法 为 FormatDate FormatDateTime 和 FormatTime， 
如 图 5. 45 所 示 。 


FormatDateTime 


图 5.45 格式 化 日 期 和 时 间 


获取 当前 时 间 (Now) 后 .就 可 以 调用 不 同 的 日 期 格式 化 输出 方法 。 例 如 当前 时 间 是 
2014-3-25 18:00:00, 调 用 时 钟 的 FormatDate 方法 ,将 Clock1. Now 拼接 在 槽 instant 中 ， 
将 输出 “日 期 ?2014-3-25; 调 用 FormatDateTime 方法 ,将 输出 “日 期 十 时 间 ”2014-3-25 下 
^F. 6:00:00; 调 用 Format Time 方法 ,将 只 输出 时间” 下午 6:00:00, 

除了 可 以 格式 化 输出 当前 时 间 外 ,还 可 以 获取 当前 时 间 的 年 (Year)、 月 (Month)\ 日 
(DayOfMontb) 、 小 时 (Hour) ,分 钟 (Minute) 、 秒 (Second) 等 信息 。 获 取 这 些 信息 都 是 通 
过 调用 时 钟 的 不 同方 法 实现 的 ,如 图 5.46 所 示 。 

在 实际 的 开发 过 程 中 ,“ 一 小 时 以 后 ”或 者 一 天 以 后 ”这 样 的 时 间 点 经 常用 到 。 这 样 
的 时 间 点 可 以 调用 时 钟 的 “时 间 增 量 ” 方 法 来 实现 。 例 如 在 图 5. 47 中 ,通过 时 钟 的 
AddHours 方法 ,将 Clock1. Now 拼装 在 槽 instant. 上 ,并 将 数字 1 拼装 在 槽 hours 上 ,就 
可 以 获取 一 个 小 时 以 后 的 时 间 点 ;同样 ,将 Clock1. Now 拼装 在 AddDays 方法 的 模 
instant 上 ,并 将 数字 1 BERE ERE days 上 ,就 可 以 获取 一 天 以 后 的 时 间 点 。 

这 些 计算 “时 间 增 量 ” 的 方法 都 是 以 Add 开头 ,除了 上 文 介绍 的 AddHours 和 AddDays 
方法 以 外 ,还 有 AddYears, AddMonths, AddMinutes, AddWeeks 和 AddSeconds 等 方法 ， 
如 图 5. 48 所 示 。 


PIC NI 


instant 


图 5.47 


call Clock] ~ _AddMonths 


Clockl + Esfera 


instant 


[PME Clock! + ERG 


计算 时 间 增 量 的 方法 


call AddWeeks 


instant 


Weeks 


[ME Cock] - MESES 


instant 


seconds 


图 5.48 其 他 计算 时 间 增 量 的 方法 


除 上 文 所 介绍 的 方法 外 ,时 钟 还 支持 一 些 其 他 用 途 的 方法 , f Duration, 
MakelnstantFromMillis 等 ,时 钟 所 支持 的 全 部 方法 如 表 5. 9 所 示 。 


表 5.9 ”时钟 所 支持 的 方法 


方法 名 称 说 明 
SystemTime 获取 手机 系统 时 间 ,单位 为 微 秒 
Now 获取 当前 时 间 点 
rt 以 “月 /日 /年 时 :分 : 秒 ”“ 月 /日 /年 "“ 时 :分 ”的 


格式 定义 时 间 点 


MakelInstantFromMillis( Number millis) 


通过 毫秒 数 定 义 时 间 点 


GetMillis(instant) 


从 1970 年 到 当前 时 间 所 经 过 的 毫秒 数量 
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续 表 

方法 名 称 说 H 
AddSeconds(instant, Number seconds) 计算 若干 秒 以 后 的 时 间 点 
AddMinutes(instant，Number minutes) 计算 若干 分 钟 以 后 的 时 间 点 
AddHours(instant, Number hours) 计算 若干 小 时 以 后 的 时 间 点 
AddDays(instant，Number days) 计算 若干 天 以 后 的 时 间 点 
AddWeeks(instant，Number weeks) 计算 若干 星期 以 后 的 时 间 点 
AddMonths(instant，Number months) 计算 若干 月 以 后 的 时 间 点 
AddYears(instant, Number years) 计算 若干 年 以 后 的 时 间 点 
Duration(Calendar start, Calendar end) 获取 两 个 时 间 点 的 时 间 差 值 , 单 位 为 毫秒 
Second( Calendar instant) 获取 时 间 点 的 秒 
Minute(Calendar instant) 获取 时 间 点 的 分 钟 
Hour(Calendar instant) 获取 时 间 点 的 小 时 


DayOfMonth(Calendar instant) 


获取 时 间 点 的 日 期 ,是 1—31 的 数字 


Weekday(Calendar instant) 


获取 时 间 点 星期 几 , 是 1( 周 日 ) 到 7( 周 六 ) 的 数字 


WeekdayName(Calendar instant) 


获取 时 间 点 的 星期 几 , 用 名 称 表述 


Month(Calendar instant) 


获取 时 间 点 的 月 份 ,用 数字 表示 


MonthName(Calendar instant) 


获取 时 间 点 的 月 份 ,用 名 称 表述 


Year(Calendar instant) 获取 时 间 点 的 年 份 
FormatDateTime(Calendar instant) 格式 化 输出 日 期 和 时 间 
FormatDate(Calendar instant) 格式 化 输出 日 期 
FormatTime(Calendar instant) 格式 化 输出 时 间 


下 面 介绍 SuperClock 示例 ,将 前 文 介绍 过 的 时 间 计 算 、 获 取 当 前 时 间 点 等 内 容 进行 
综合 应 用 介绍 。SuperClock 示例 运行 界面 如 图 5. 49 所 示 ,用 户 单 击 不 同 按钮 ,将 在 “这 
里 显示 时 间 信 息 ” 的 标签 控件 中 显示 时 间 信 息 。 

在 界面 设计 器 上 ,可 以 找到 Non-visible components( 非 可 视 化 ) 模 块 的 时 钟 控 件 , 如 
图 5. 50 所 示 。 

SuperClock 示例 的 全 部 逻辑 模块 如 图 5.51 所 示 。 

时 钟 的 另 一 种 用 法 是 作为 “定时 器 ,按照 固定 的 时 间 间 隔 产生 触发 事件 (Timer) 。 
时 钟 有 3 个 相关 的 属性 ,如 表 5. 10 所 示 。TimerInterval 用 来 设 定 触发 的 时 间 间 隔 ,单位 
为 毫秒 。TimerEnabled 控制 着 时 钟 的 运行 ,可 以 通过 修改 TimerEnabled 属性 停止 和 启 
动 时 钟 。TimerAlwaysFires 是 多 次 触发 开关 ,如 果 TimerAlwaysFires 没有 被 选中 , 则 产 
生 一 次 触发 事件 后 ,不 会 继续 产生 和 触发 事件 ;反之 , 则 会 按照 时 间 间 隔 不 断 产 生 触 发 事件 。 
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这 里 显示 时 间 信 息 


当前 时 间 。 一 小 时 以 后 | 一 天 以 后 


当前 日 期 年 月 日 


5.49 SuperClock 示例 运行 界面 


Viewer 


Gioispiay hdcen components in Viewer 
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图 5.50 SuperClock 示例 的 界面 设计 图 
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图 5.51 SuperClock 示例 全 部 逻辑 模块 


表 5.10 时 钟 的 属性 


模式 说 明 模式 说 明 
TimerInterval 时 间 间 隔 TimerAlwaysFires | 多 次 产生 定时 器 事件 开关 
TimerEnabled 时 钟 启动 开关 


时 钟 只 有 一 个 触发 事件 Timer, 如 图 5.52 所 示 。 时 钟 被 启动 后 (TimerEnabled) ,经 
过 预定 的 时 间 间 隔 (TimerInterval) ,将 产生 时 钟 的 触发 事件 。 

下 面 通过 TimerClock 示例 介绍 如 何 使 用 时 钟 的 “定时 器 ”功能 ,其 中 还 用 到 了 本 章 介 
绍 过 的 选项 列表 控件 。TimerClock 示例 的 运行 界面 如 图 5. 53 所 示 。 

在 用 户 单 击 “ 启 动 计数 器 ”按钮 后 ,时 钟 开始 计时 ,并 在 界面 上 显示 计时 数字 ,如 图 5. 54 
所 示 。 按 钮 显示 的 文字 由 “启动 计数 器 " 变 为 “停止 计数 器 *。 这 时 如 果 再 次 单 击 按钮 ,时 
钟 将 停止 计时 。 界 面 下 方 的 “选择 时 间 间 隔 ( 单 位 毫秒 )” 列 表 选 项 ,可 以 控制 时 钟 触 发 事 
件 的 时 间 间 隔 ,在 选择 不 同 的 数值 后 ,计数 器 的 触发 时 间 间 隔 会 立即 被 修改 ,反映 在 界面 
中 间 的 数值 变化 速度 上 。 选 项 列表 可 以 选择 的 数字 有 100(0. 1 秒 )、500(0.5 秒 )、1000 
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(1 秒 ) 和 2000(2 $). 


计数 器 


[E] 


一 


启动 计数 器 


选择 时 间 间 隔 ( 单位 毫秒 ) 


=Z L 
LAGU Clock! ~ utu 计时 器 时 间 间 隔 : 1000. 


图 5.52 时钟 的 触发 事件 5.53  TimerClock 示例 运行 界面 
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图 5.54 TimerClock 示例 的 界面 设计 图 
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— tš | ++ ç HEX App Inventor 2 (第 2 路 ) 


TimerClock 示例 的 逻辑 设计 分 为 4 个 部 分 ,分 别 是 初始 化 选项 列表 、 选 后 操作 事件 、 
时 钟 触发 事件 和 按钮 单 击 事件 。 

第 一 部 分 逻辑 功能 是 初始 化 选项 列表 。 一 般 的 初始 化 工作 都 在 软件 启动 时 进行 ,在 
AI2 中 ,屏幕 页 Screenl 的 Initialize 方法 是 在 加 载 屏幕 页 的 时 候 被 调用 ,因此 可 以 认为 是 
在 软件 初始 化 的 时 候 被 调用 ,所 以 Initialize 方法 通常 用 来 完成 列表 、 赋 值 等 初始 化 工作 。 
例如 给 选项 列表 ListPickerl 的 Elements 属性 赋值 ,用 make a list 模块 将 文本 100,500, 
1000 和 2000 生成 列表 ,如 图 5. 55 所 示 。 


Eu . Initialize 


do 


set to make a list 


图 5.55 初始 化 列表 


第 二 部 分 是 列表 的 选 后 操作 事件 的 逻辑 功能 。 用 户 选择 列表 项 后 产生 选 后 操作 事 
件 , 此 时 需要 完成 的 功能 是 将 用 户 的 选择 结果 赋值 给 时 钟 Clockl 的 TimerInterval 属性 ， 
用 来 修改 时 钟 的 触发 时 间 间 隔 。 同 时 ,将 选择 结果 赋值 给 标签 LabelValue 的 Text 属性 ， 
如 图 5. 56 所 示 ,把 选择 结果 显示 到 用 户 界面 上 。 


when 


ListPickerl ~ ad sura 
dal set to 
EX EE ListPickerl ~ 


5.56 选 后 操作 事件 


第 三 部 分 是 时 钟 触发 事件 的 逻辑 功能 。 每 次 时 钟 触发 后 ,修改 标签 LabelCount 的 
Text 属性 ,将 其 数值 增加 1, 如 图 5.57 所 示 ,屏幕 上 会 出 现 1.2、3、4、.5…… 的 计数 信息 递 
增 效果 。 


Lu MEM Clockl - Bitsg 


do e 


A 


图 5.57 ”时钟 触发 事件 


第 四 部 分 是 按钮 单 击 事件 的 逻辑 功能 ,如 图 5. 58 所 示 。 

首先 定义 一 个 全 局 变量 running, 表 示 时 钟 是 否 开始 计数 ,将 其 赋值 为 false。 在 按钮 
Buttonl 的 单 击 事件 Click 中 ,判断 全 局 变量 running 的 值 ,决定 所 作 的 动作 。 

如 果 running 为 false, 表示 时 钟 没 有 启动 ,进入 else 分支 。 先 将 running 赋值 为 
true; 再 将 按钮 Buttonl 的 Text 属性 赋值 为 “停止 计数 器 ”; 然 后 将 标签 LabelCount 的 属 
性 Text 赋值 为 0, 相 当 于 清空 计时 器 的 内 容 ; 最 后 将 时 钟 Clock1 的 TimerEnabled 属性 
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initialize global 


when Click 
lobal running ` KJ 


图 5.58 按钮 单 击 事件 


赋值 为 true, 则 会 立即 启动 时 钟 ,开始 计数 过 程 。 

如 果 running 为 true, 表示 时 钟 已 经 启动 ,进入 then 分 支 , 则 先 将 running 赋值 为 
false, 然 后 将 按钮 Buttonl 的 Text 属性 赋值 为 “启动 计数 器 ”, 最 后 将 时 钟 Clockl 的 
TimerEnabled 属性 赋值 为 false, 立 即 停止 时 钟 。 

TimerClock 示例 的 全 部 逻辑 模块 如 图 5. 59 所 示 。 


when IIT. Initialize 
do set 


图 5.59 TimerClock 示例 的 全 部 逻辑 模块 


5.3.5 滑动 条 
Slider( 滑 动 条 ) 是 一 个 可 以 拖 动 的 进度 条 控件 ,如 图 5. 60 所 示 , 用 户 可 以 通过 拖 动 滑 


块 修改 滑动 条 的 当前 值 (ThumbPosition) ,经 a 
常用 于 通过 可 视 化 的 方法 持续 修改 数值 。 
滑动 条 的 属性 如 图 5. 61 所 示 , 其 中 , 属 图 5.60 滑动 条 


性 ColorLeft 表示 滑动 条 上 滑 块 左 侧 的 颜色 ; 
属性 ColorRight 表示 滑 块 右 侧 的 颜色 ;MaxValue 表示 滑动 条 的 最 大 值 ;MinValue 表示 
滑动 条 的 最 小 值 ;ThumbPosition 表示 滑 块 的 当前 值 。 

滑动 条 支持 PositionChanged( 位 置 改变 ) 事 件 ,该 事件 在 滑 块 滑动 过 程 中 将 持续 被 触 
发 ,如 图 5. 62 所 示 。 
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在 介绍 下 一 个 示例 前 ,这 里 先 介 绍 一 下 AI2 的 颜色 系统 。 在 模块 编辑 器 中 的 Blocks— 
Build-in-* Colors 目录 中 ,AI2 给 出 了 多 个 预 设 的 颜色 供用 户 使 用 ,包括 经 常 使 用 的 白色 、 
黑色 、 黄 色 、 蓝 色 、 灰 色 、 红 色 及 粉色 等 ,如 图 5.63 所 示 。 


Slider1 - ATE 

zs m LUE Slider! + ZEE VIENT 
ColorLeft 
B] omanoe 
ColorRight 
Wes 
MaxValue 
3 图 5.62 滑动 条 的 PositionChanged 事件 
MinValue 
n 7] o 
Thumbposition 
101 418 
Visible 

= a c0 
Width 
= ccm 


图 5.61 滑动 条 的 属性 图 5.63 AD 的 预 设 颜色 


为 了 能 够 呈现 更 多 颜色 ,AI2 支持 使 用 三 原色 的 方式 创建 颜色 ,位 置 在 Blocks 一 
Build-in-*Colors 目录 下 ,如 图 5. 64 所 示 。 将 三 原色 ( 红 ,、 绿 、 蓝 ) 以 列表 的 形式 传递 给 
make color, 在 创建 列表 时 ,列表 的 第 一 项 表示 红色 ,列表 的 第 二 项 表示 绿色 ,列表 的 第 三 
项 表示 蓝 色 ,数值 的 范围 为 0~255。 


make color [| J make a list 


图 5.64 创建 颜色 


下 面 以 SliderColor 示例 说 明 如 何 使 用 滑动 条 。SliderColor 示例 中 使 用 了 3 个 滑动 
条 来 调节 3 种 原色 (红色 、 绿 色 和 蓝 色 ) 的 比例 ,从 而 改变 界面 上 “显示 颜色 区 ”的 颜色 。 
SliderColor 示例 的 运行 界面 如 图 5. 65 所 示 。 

在 界面 编辑 器 中 ,将 3 个 滑动 条 的 MaxValue 属性 设置 为 255,MinValue 属性 设置 为 
0。 为 了 便于 显示 三 原色 的 值 , 将 这 3 个 值 以 *“ 红 , 绿 . 蓝 ”的 形式 显示 在 标签 “颜色 值 ?的 后 
面 。 用 标签 LabelArea ,显示 文字 “颜色 显示 区 ”, 将 其 宽度 设置 为 fill parent, AERAN 
100 像素 ,如 图 5.66 所 示 。 
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图 5.65 SliderColor 示例 运行 界面 
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5.66 SliderColor 示例 的 界面 设计 图 


在 逻辑 部 分 中 首先 定义 3 个 全 局 变量 red, green 和 blue, 用 来 代表 三 原色 的 值 ,如 
图 5.67 所 示 。 

然后 定义 ChangeColor 函数 ,用 来 根据 全 局 变 
Ht red, green 和 blue 的 值 改 变 “ 颜 色 显 示 区 ”的 颜 | 
色 , 并 将 三 原色 的 值 显示 在 标签 LabelValue 中 ,如 
图 5.68 所 示 。 

最 后 来 处 理 滑动 条 的 PositionChanged 事件 。 
在 任意 滑动 条 的 滑 块 被 拖 动 引发 数值 变化 时 ,将 这 个 数值 直接 赋值 给 全 局 变量 ,然后 调用 
函数 ChangeColor 改变 “颜色 显示 区 ”的 颜色 ,如 图 5. 69 所 示 。 


initialize global 


initialize globalfl 


图 5.67 全 局 变量 red、green 和 blue 
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图 5.69 滑动 条 的 PositionChanged 事件 
SliderColor 示例 的 全 部 逻辑 模块 如 图 5. 70 所 示 。 


Lad elo blue `] 


5.70 SliderColor 示例 的 全 部 逻辑 模块 


5.3.6 网 页 浏览 器 


WebViewer( 网 页 浏览 器 ) 是 用 来 显示 网 页 的 控件 ,用 户 可 以 设置 主页 (HomeUrl)， 
也 可 以 打开 某 个 指定 的 页 面 ,并 支持 在 浏览 记录 中 进行 查看 已 打开 过 的 页 面 ,图 标 如 
图 5.71 所 示 。 但 需要 注意 的 是 ,这 并 不 是 一 个 全 功能 的 网 页 浏览 器 ,因此 如 果 用 户 按 回 
退 键 ,将 直接 退出 网 页 浏览 器 所 在 的 应 用 程序 ,而 不 是 切换 到 上 一 个 浏览 过 的 页 面 。 
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图 5.71 网 页 浏览 器 图 标 


网 页 浏览 器 支持 设置 主页 (HomeUrl) ,支持 显示 当前 页 面 的 标题 (CurrentPageTitle) 和 
URL(CurrentUrl) ,可 以 控制 是 否 允 许 打开 其 他 链接 (FollowLinks)。 网 页 浏览 器 所 支持 
的 全 部 属性 如 表 5. 11 所 示 。 


表 5.11 网 页 浏览 器 的 属性 及 说 明 


属 人 性 说 H 
CurrentPageTitle 当前 页 面 的 标题 
CurrentUrl 当前 页 面 的 URL 


设置 是 否 允许 用 户 通过 单 击 页 面 的 链接 进入 其 他 页 面 。 如 果 人 允许 , 则 可 以 
使 用 GoBack 或 GoForward 函数 在 浏览 器 的 历史 记录 中 进行 导航 


FollowLinks 


HomeUrl 用 来 设置 主页 ,标识 网 页 浏览 器 初始 化 打开 时 加 载 的 页 面 
PromptforPermission | 设置 是 否 允许 网 页 浏览 器 访问 有 关 地 理 位 置 的 APT 

UsesLocation 设置 是 否 允 许 应 用 使 用 Javascript 的 地 理 位 置 API, 仅 在 界面 编辑 器 中 有 效 
Visible 设置 网 页 浏览 器 是 否 可 见 

Width 设置 网 页 浏览 器 的 宽度 

Height 设置 网 页 浏览 器 的 高 度 


网 页 浏览 器 不 支持 任何 事件 ,但 支持 多 个 方法 ,包括 GoToUrl( 打 开 指定 的 URL), 
GoHome( 打 开 主 页 )、ClearLocations (清除 位 置信 息 )、CanGoForward( 检 测 是 否 可 以 在 
浏览 历史 记录 中 前 进 ) 或 者 CanGoBack( 后 退 )、GoForward( 打 开 浏 览 历 史记 录 中 前 一 个 
页 面 ) 或 者 GoBack( 后 一 个 页 面 )。 网 页 浏览 器 支持 的 全 部 方法 如 图 5.72 所 示 。 


图 5.72 网 页 浏览 器 的 事件 


这 里 使 用 最 简单 的 按钮 .标签 和 网 页 浏览 器 控件 ,创建 一 个 实用 的 浏览 器 示例 
MiniWeb。 示 例 的 运行 界面 如 图 5.73 所 示 ,用 户 可 以 在 文本 框 中 输入 希望 浏览 的 网 页 地 
址 ,默认 的 地 址 是 http://www. google. com. hk。 在 用 户 单 击 “ 对 号 ”按钮 后 ,下 方 会 打开 
链接 地 址 的 页 面 。 单 击 界面 上 方 的 “ 回 退 和“ 前进” 按钮 ,可 以 在 已 经 浏览 过 的 页 面 之 间 
进行 切换 。 两 个 按钮 之 间 显 示 的 是 当前 页 面 的 标题 ,填写 链接 地 址 的 文本 框 下 方 显示 的 
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是 当前 页 面 的 地 址 。 
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5.73 MiniWeb 示例 运行 界面 


在 界面 编辑 器 中 ,将 需要 使 用 的 3 个 图 片 文 件 上 传 到 媒体 区 ,并 在 按钮 上 使 用 这 些 图 
Hr ,保持 按钮 的 ShowFeedback 属性 被 勾 选 ,在 按钮 的 图 片 被 单 击 时 呈现 灰白 色 的 视觉 反 


馈 。 在 MiniWeb 示例 中 放 


置 一 个 时 钟 控件 ,如 图 5. 74 所 示 ,作用 是 使 浏览 器 在 指定 的 时 


间 间 隔 内 (1 秒 ) 内 持续 更 新 界面 所 显示 的 当前 页 面 标题 和 地 址 。 
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5.74 MiniWeb 示例 的 界面 设计 图 
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在 模块 编辑 器 中 ,首先 设 定 “ 对 号 ”按钮 (ButtonGo) 的 单 击 事件 。 在 按钮 被 单 击 后 ， 
调用 WebView 控件 的 GoToUrl 方法 ,将 文本 框 TextBoxl 的 Text 属性 传递 给 GoToUrl 
方法 ,WebView 控件 会 直接 打开 Text 属性 指定 的 网 页 。 同 时 将 时 钟 控件 Clockl 的 
TimeEnabled 属性 设置 为 真 ,用 来 启动 时 钟 。ButtonGo 的 单 击 事件 如 图 5. 75 所 示 。 


ba ButtonGo * bt 


do 


call 


图 5.75 ButtonGo 的 单 击 事件 


在 时 钟 被 启动 后 ,就 会 按照 界面 编辑 器 中 时 钟 控件 设 定 每 间隔 (1 秒 ) 引 发 Timer 时 
间 。Timer 事件 主要 是 用 WebView1 控件 提供 的 CurrentUrl 属性 和 CurrentPageTitle 
属性 ,更 新 显示 当前 页 面 的 地 址 和 标题 ,如 图 5.76 所 示 。 


when Tiner 
do set 


图 5.76 Clock 的 Timer 事件 


Be Ji ALH“ [| iB "TZ 4H (ButtonBack) £f" ñij BE” f tH CButtonForward) 的 单 击 事件 。 
在 “ 回 退 "按钮 的 单 击 事件 中 ,不 能 够 直接 调用 WebView 控件 的 回 退 方法 (GoBack) ,需要 
先 调用 CanGoBack 方法 做 个 判定 ,如 果 WebView 控件 可 以 进行 “返回 "操作 , 才 可 以 调用 
GoBack 方法 进行 回 退 。“ 前 进 ” 按 钮 的 单 击 事件 与 之 相似 ,如 图 5.77 所 示 。 


ButtonForward ~ BOET s 


do if call oForward 


then call 


vw 


Æ 5.77 ButtonBack 和 ButtonForward 的 单 击 事件 
MiniWeb 示例 的 全 部 逻辑 模块 如 图 5. 78 所 示 。 


5.3.7 通知 控件 


Notifier( 通 知 控件 ) 主 要 用 来 显示 对 话 框 信息 和 浮动 提示 信息 ,并 支持 输出 Android 
系统 的 Log 日 志 , 如 图 5.79 所 示 。 输 出 Android 系统 的 Log 日 志 并 不 能 直接 显示 在 用 
户 界面 上 ,但 这 种 方法 可 以 用 于 开发 阶段 的 程序 调试 。 
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图 5.78 MiniWeb 示例 的 全 部 逻辑 模块 


Arte 这 是 一 条 浮动 提示 信息 


Text Dialog 


Choose Dialog Input the text 
YES NO Cancel | OK | CANCEL | 


图 5.79 通知 控件 


通知 控件 提供 了 多 种 不 同 的 方式 与 用 户 交 互信 息 ,包括 弹出 浮动 消息 以 及 弹出 多 种 类 型 
的 对 话 框 。 这 些 交互 方式 是 通过 使 用 通知 控件 的 7 种 方法 实现 的 ,包括 ShowMessageDialog 
(显示 消息 对 话 框 ) .ShowChooseDialog( 选 择 对 话 框 ) 和 ShowTextDialog( 文 本 对 话 框 ) 以 
及 ShowAlert( 显 示 浮 动 消息 ), 还 有 向 Android 系统 的 Log 日 志 中 写 人 LogError( 错 误 
信息 )、LogInfo( 提 示 信 息 ) 和 LogWarning( 警 告 信息 ) 等 ,如 表 5. 12 所 示 。 


表 5.12 通知 控件 的 方法 及 说 明 


y 法 j — H 
ShowMessageDialog 显示 消息 对 话 框 ,只 有 一 个 按钮 ,可 设 定 按钮 显示 的 文字 
ShowChooseDialog 显示 选择 对 话 框 ,有 两 个 或 3 个 按钮 ,并 可 设 定 按钮 显示 的 文字 
ShowTextDialog 显示 文本 对 话 框 ,可 在 对 话 框 中 输入 文字 
ShowAlert 显示 浮动 信息 
LogError Log 日 志 的 错误 信息 
LogInfo Log 日 志 的 提示 信息 
LogWarning Log 日 志 的 警告 信息 


如 图 5. 80 所 示 ,通知 控件 支持 的 属性 有 BackgroundColor( 文 本 背景 颜色 ) , TextColor 
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(文本 颜色 ) 和 NotifierLength( 浮 动 消息 显示 时 间 ), 这 3 个 属性 只 对 浮动 消息 生效 ,对 对 
话 框 是 不 产生 任何 效果 的 。 


BackgroundColor 
W DarkGray 


NotifierL ength 
tong "| 


4 BackgroundColor TextColor 
TextColor [] White 


图 5.80 通知 控件 的 属性 


通知 控件 支持 AfterChoosing( 选 择 后 事件 ) 和 AfterTextInput( 输 入 后 事件 )。 选 择 
后 事件 在 用 户 选 择 对 话 框 中 做 出 选择 后 产生 ,一般 与 ShowChooseDialog 方法 联合 使 用 ; 
输入 后 事件 是 用 户 在 文本 对 话 框 中 输入 文本 ,在 并 关闭 对 话 框 时 产生 ,一 般 与 
ShowTextDialog 方法 联合 使 用 ,如 图 5. 81 所 示 。 


LUE Notifierl -国人 at LUE Notifierl * E ai 


图 5.81 通知 控件 支持 的 事件 


下 面 在 ShowMessage 示例 中 演示 如 何 使 用 通知 控件 。ShowMessage 示例 的 运行 界 


面 如 图 5.82 所 示 ,上方 有 4 个 按钮 ,在 用 户 单 


击 这 些 按钮 后 ,会 对 应 产生 浮动 消息 .选择 对 选择 显示 的 消息 类 型 : 


话 框 、 消 息 对 话 框 和 文本 对 话 框 ,并 且 在 用 户 浮动 信息 
对 对 话 框 做 出 选择 或 者 输入 文字 后 ,在 “提示 
信息 ”区 域 会 有 相应 的 显示 。 选择 对 话 框 


界面 编辑 器 中 的 ShowMessage 示例 界面 . 
设计 如 图 5. 83 所 示 , 界 面 主要 由 按钮 和 标签 消息 对 话 框 
组 成 , 非 可 视 化 控件 Notifierl 的 文字 背景 颜 文本 对 话 框 


色 选 择 黑色 ,文字 颜色 选择 白色 ,通知 的 时 间 
长 度 选择 较 长 时 间 (Long)。 
在 ButtonAlert 按钮 的 单 击 事件 中 .调用 | 
通知 控件 的 ShowAlert 方法 ,并 将 需要 显示 的 
文本 消息 拼接 在 ShowAlert 方法 的 槽 notice M 5:82. Show Messe m 


上 ,如 图 5. 84 所 示 。 
当 用 户 单 击 “ 浮 动 消息 ”按钮 后 ,在 手机 屏幕 上 将 显示 如 图 5. 85 所 示 的 文本 信息 。 
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B Display hidden components in Viewer e Missen 
四 Labariue | 
国 ButtonNer | 
选择 中 示 的 消息 类 型 : | 国 BuronchooseDialog — | 
浮动 信息 国 soonwessooepalog | 
- - 网 国 BuronTenDialog | 
选择 对 话 框 [A Lebelinfo | 
消息 对 话 框 | Å notifiert | 


文本 对 话 杠 | 


Non-visible components 一 一 


A Mesa 


Notifier1 I 
Upload File | 


Rename Delete 


图 5.83 ShowMessage 示例 界面 设计 示意 图 


ButtonAlert "Mutius 


.ShowAlert 


notice [一 下 和 
显示 一 条 浮动 信息 


图 5.84 ButtonAlert 按钮 单 击 事件 图 5.85 浮动 消息 


在 ButtonChooseDialog 按钮 的 单 击 事件 中 ,调用 通知 控件 的 ShowChooseDialog 方法 ,会 
在 手机 屏幕 上 显示 一 个 具有 “是 ”和 “ 否 ” 两 种 选择 的 选择 对 话 框 ,如 图 5. 86 Bron. 
ShowChooseDialog 方法 的 各 个 槽 与 选择 对 话 框 中 显示 内 容 的 对 应 关系 为 , 槽 message 是 
对 话 框 中 显示 的 内 容 , 模 title 是 对 话 框 的 标题 , 槽 buttonI Text 是 第 一 个 按钮 显示 的 文 
字 , 槽 button2Text 是 第 二 个 按钮 显示 的 文字 , 槽 cancelable 代表 对 话 框 中 是 否 会 出 现 第 
三 个 写 着 “Cancel” 的 按钮 ,用 来 表示 用 户 不 做 出 任何 选择 。 


Mt ButtonChooseDialog -BMA EGS 


图 5.86 ButtonChooseDialog 按钮 的 单 击 事件 


当 用 户 单 击 * 选 择 对 话 框 ?按钮 后 ,手机 屏幕 上 会 出 现 选择 对 话 框 , 用 户 做 出 选择 后 ， 


Er 


ShowMessage 示例 显示 的 选择 结果 如 图 5. 87 所 示 。 
选择 显示 的 消息 类 型 : 
K 
选择 对 话 框 
VES 
选择 对 话 杠 == 
请 在 "是 "与 否 " 之 间 做 出 选择 文本 对 话 框 


图 5.87 选择 对 话 框 和 结果 显示 


选择 结果 的 显示 ,是 通过 调用 AfterChoosing 事件 实现 的 ,参数 choice 代表 用 户 的 选 
择 , 实 际 上 是 用 来 进行 选择 的 按钮 上 的 文字 。 例 如 ,如 果 用 户 选 择 单 击 “ 是 ”按钮 , 则 参数 
choice $ F fT tB " J& " 如 果 用 户 单 击 “ 否 ”按钮 , 则 参数 choice 是 字符 串 “ 否 ”。 在 
AfterChoosing 事件 中 ,只 是 将 用 户 的 选择 信息 显示 在 标签 LabelInfo 中 ,如 图 5. 88 
BUR o 


Wit Notifierl "EENES UTN] 


do 


5.88  AfterChoosing 事件 


在 ButtonMessageDialog 按钮 的 单 击 事件 中 ,使 用 通知 控件 的 ShowMessageDialog 
方法 可 以 显示 消息 对 话 框 。 槽 message 是 消息 对 话 框 的 消息 内 容 , 槽 title 是 消息 对 话 框 
的 标题 , 槽 buttonText 是 消息 对 话 框 按钮 的 文字 ,如 图 5. 89 所 示 。 


DAE ButtonMessageDialog "RAEN 
COE SENE Notifier! + AUS GETE 
me: ge 


title 


buttonText 


Æ 5.89 ButtonMessageDialog 事件 
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当 用 户 单 击 “ 消 息 对 话 框 ”按钮 后 ,手机 屏幕 
-会 出 现 如 图 5. 90 Br ids Bod ied, vds Kris beard 
出 ?按钮 ,消息 对 话 框 会 被 自动 关闭 。 

在 ButtonTextDialog 按钮 的 单 击 事件 中 ,使 
用 通知 控件 的 ShowTextDialog 方法 可 以 显示 文 
SEXES TE. BE message 是 对 话 框 的 消息 内 容 , 醒 
title 是 对 话 框 的 标题 , 槽 cancelable 表示 是 否 显示 图 5.90 消息 对 话 框 
Cancel 按钮 ,如 图 5.91 所 示 。 


这 里 显示 消息 的 具体 内 容 


cancelable M 


图 5.91 ButtonTextDialog 按钮 单 击 事件 
当 用 户 单 击 “ 文 本 对 话 框 ”按钮 后 ,手机 屏幕 上 会 出 现 文本 对 话 框 。 用 户 在 文本 框 输入 
内 容 后 单 击 OK 按钮 ,可 以 返回 给 文本 对 话 框 的 调用 者 。 图 5. 92 所 示 是 ShowMessage 
示例 显示 的 文本 框 , 并 将 文本 框 中 输入 的 内 容 显示 在 主 界面 上 。 


ShowMessage 
选择 显示 的 消息 类 型 : 
浮动 信息 
文本 对 话 框 选择 对 话 杠 
请 输入 文本 信息 消息 对 话 杠 
哈尔滨 工程 大 学 文本 对 话 框 


-| MEN 


5.92 文本 对 话 框 和 结果 显示 


之 所 以 可 以 捕获 用 户 在 文本 对 话 框 中 的 输入 内 容 , 是 因为 示例 中 使 用 了 
AfterTextInput 事件 。 用 户 单 击 OK 按钮 会 触发 AfterTextInput 事件 ,输入 文本 对 话 框 
的 信息 会 被 传递 到 参数 response 中 ;但 如 果 用 户 单 击 Cancel 按钮 ,参数 response 获取 到 
的 字符 串 则 为 Cancel。AfterTextInput 事件 只 是 将 response 返回 的 信息 显示 在 标签 
LabelInfo 中 ,如 图 5. 93 所 示 。 

ShowMessage 示例 的 全 部 逻辑 模块 如 图 5. 94 所 示 。 
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图 5.93 AfterTextInput 事件 


en ET .Click 
do. cali Eo " "auno umm 


5.94 ShowMessage 示例 的 全 部 逻辑 模块 


CASE 


1. 水 平 布局 控件 和 垂直 布局 控件 能 否 被 表格 布局 控件 代替 ? 为 什么 ? 

2. 控件 的 属性 和 方法 在 使 用 上 有 什么 区 别 ? 

3. 用 常用 控件 完成 一 个 “动态 相册 ”应 用 程序 ,用 户 可 以 通过 选项 列表 调整 动态 相册 中 
照片 的 更 换 速度 ,并 可 以 通过 单 击 “ 开 始 ”“ 和 暂停 "和 “停止 "按钮 进行 控制 ,如 图 5.95 所 示 。 
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5.95 动态 相册 


游戏 开发 是 在 AI2 中 最 有 趣 的 部 分 ,用 户 只 要 使 用 画布 和 精灵 ,就 可 以 完成 简单 的 
游戏 开发 ;再 辅 以 一 些 高 级 的 游戏 功能 ,如 边缘 检测 、 碰 撞 处 理 和 精灵 操纵 等 ,就 会 使 游戏 
会 变 得 精彩 、 耐 玩 。 


本 章 学 习 目标 

党 所 画布 的 使 用 方法 

。 理解 画布 的 坐标 系统 

。 掌握 精灵 的 使 用 方法 

+ 掌握 球 (Ball) 的 使 用 方法 

。 了 解 边 缘 检 测 和 碰撞 处 理 的 原理 
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6.1.1 画布 坐标 系 


画布 (Canvas) 是 一 种 可 在 其 上 绘制 图 像 的 控件 ,初始 的 画布 像 一 张 空白 的 幻灯 片 ， 
没有 任何 内 容 , 用 户 可 以 在 画布 上 绘制 各 种 图 
形 , 例 如 线条 ,点 、 和 矩形 或 圆 形 ;也 可 以 在 画布 
上 加 载 图 片 作为 画布 的 背景 ,或 在 画布 上 显示 
文字 。 画 布 除了 作为 绘制 图 形 的 承载 体 以 外 ， 
在 游戏 开发 中 也 是 重要 的 组 成 部 分 ,用 来 承载 
图 像 精 灵 和 显示 游戏 背景 画面 。 

画布 是 一 个 具有 和 触 控 感 应 的 二 维 平面 图 
板 ,采用 经 典 的 二 维 坐标 系 , 坐 标的 原点 在 画 
布 的 左上 角 。 例 如 图 6. 1 中 的 坐标 点 (X,Y)， 
X 表示 坐标 点 距离 左 侧 边缘 的 距离 ,Y 表示 坐 
标点 距离 上 边缘 的 距离 , 且 X 和 YY 都 取 正 值 。 


6.1.2 画布 使 用 


在 绘图 和 动画 控件 (Drawing and Animation) 库 中 可 以 找到 画布 (Canvas) 控 件 。 将 
画布 拖 忠 到 界面 设计 区 后 ,画布 仅仅 显示 为 一 个 小 图 标 ,如 图 6.2 所 示 。 要 让 画布 填充 满 


图 6.1 画布 的 二 维 坐标 系 


958 游戏 开发 


整个 屏幕 ,只 需 手动 设置 画布 的 宽度 (Width) 和 高 度 (Height) 即 可 。 

除了 使 用 宽度 和 高 度 属 性 可 以 控制 画布 的 大 小 以 外 ,画布 还 支持 更 改 背景 颜色 
(BackgroundColor) 更改 背景 图 片 (BackgroundImage)、 设 置 画笔 的 颜色 (PaintColor) 和 
宽度 (Linewidth) 以 及 画布 是 否 可 见 (Visible) 等 属性 。 画 布 的 全 部 属性 如 图 6. 3 所 示 。 
属性 说 明 如 表 6. 1 所 示 。 


Canvas1 
BackgroundColor 
White 
Backgroundlmage. 
| None. | 
FontSize 
| 14.0 | 
LineWidth 
r as lpispay hidden components in Viewer 20 | 
. PaintColor 
User Interface W Black 
Layout TextAlignment 
center 
Media 
Visible 
Drawing and Animation showing [x] | 
/9 Bal o Width 
Automatic. | 
¿Ë ImageSprite [o] eem | 
图 6.2 画布 控件 图 6.3 画布 属性 
表 6.1 画布 的 属性 及 说 明 
属 性 说 明 属 性 说 明 
BackgroundColor 背景 颜色 TextAlignment 文字 排列 方式 
BackgroundImage 背景 图 片 Visible 画布 控件 是 否 可 见 
FondSize 字体 大 小 Width 画布 宽度 
Linewidth 画笔 宽度 Height 画布 高 度 
PaintColor 画笔 颜色 


画布 支持 画布 清空 (Clear) ,绘制 直线 (DrawLine) 绘制 圆 点 (DrawPoint) 、 绘 制 文字 
(DrawText) 和 画布 保存 (Save) 等 方法 ,如 表 6. 2 所 示 。 

画布 所 支持 的 方法 中 , 像 Clear 和 Save 是 不 需要 用 户 提供 任何 参数 的 ,但 绝 大 多 数 
方法 都 需要 用 户 提供 坐标 作为 基本 参数 ,如 DrawPoint 和 GetPixelColor。 画 布 所 支持 的 
方法 以 及 需要 用 户 提供 的 参数 如 图 6.4 所 示 。 
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表 6.2 画布 控件 方法 说 明 

方 法 说 明 
Clear 画布 清空 
DrawCircle 绘制 圆 形 图 形 
DrawLine 绘制 线条 
DrawPoint 绘制 圆 点 
DrawText 绘制 文字 
DrawTextAtAngle 以 一 定 角度 绘制 文字 
GetBackgroundPixelColor 获取 背景 图 片 指定 像素 的 颜色 
GetPixelColor 获取 图 片 指定 像素 的 颜色 
Save 画布 保存 
SaveAs 画布 另存 为 
SetBackgroundPixelColor 设置 背景 图 片 特定 像素 的 颜色 


可 视 化 开发 Android 应 用 程序 


图 6.4 画布 的 方法 


Clear 方法 可 以 清空 画布 元 素 . 如 果 画 布 上 已 设置 图 片 , 设 置 的 图 片 会 被 清空 。 
DrawCircle 方法 可 以 在 画布 上 的 (x,y) 点 绘制 一 个 半径 为 7 的 圆 形 。DrawLine 方法 会 在 画 
布 上 从 (zl1,yD) 点 到 (zx2,y2) 点 绘制 一 条 直线 。DrawPoint 方法 会 在 画布 (z,y) 点 上 绘制 一 
个 圆 点 。DrawText 方法 会 在 (z,y) 点 绘制 文字 Text, Draw TextAtAngle 方法 会 在 (z,y) 点 
以 角度 angle 绘制 文字 Text 。GetBackgroundPixelColor 方法 会 获取 背景 图 片上 (z,y) 点 的 
颜色 。GetPixelColor 方 法 会 获取 前 景 上 (z,y) 点 的 颜色 。SetBackgroundPixelColor 方 
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法 会 设置 背景 图 片上 (zx,y) 点 的 颜色 为 color, 

Save 方法 可 将 画布 图 像 存 储 到 外 部 存储 器 的 默认 路 径 中 ,并 返回 存储 的 路 径 和 文件 
名 ; 若 存 储 发 生 错 误 , 则 会 返回 错误 信息 。SaveAs 方法 可 以 将 画布 图 像 存储 到 外 部 存储 
器 中 ,并 指定 文件 名 filename, 文 件 名 的 后 级 必须 为 jpeg、jpg 或 png. 

画布 支持 的 事件 有 拖 蝶 事件 (Dragged) , fih if F fF (Touched) , Xil zh 58 fF CFlung) , d 
下 事件 (TouchDown) 和 抬 起 事件 (TouchUp) ,如 表 6. 3 和 图 6.5 所 示 。 


表 6.3 画布 事件 及 说 明 


# 件 说 明 
Dragged 拖 电 事件 
Flung 划 动 事件 
TouchDown 按 下 事件 
TouchUp 抬 起 事件 
Touched 和 触 碰 事件 ,由 触 磁 按 下 动作 和 触 碰 抬 起 动作 组 成 


when Dragged 


when Touched EMEN . TouchDown 


图 6.5 画布 事件 


下 面 介绍 画布 事件 的 响应 规律 。 如 图 6.6 Bros ,手指 首先 在 A 点 按 下 ,此 时 将 产生 
TouchDown 事件 :手指 从 A 点 抬 起 ,将 产生 TouchUp 事件 和 Touched 事件 。 

如 果 手 指 从 A 点 按 下 .缓慢 沿 弧 线 从 B 点 滑动 到 C 点 ,然后 抬 起 手指 , 当 手 指 接触 到 
A 点 时 ,将 产生 TouchDown 事件 ;在 手指 从 A 到 B 再 到 C 的 移动 过 程 中 ,将 多 次 产生 
Dragged 事件 ;在 手指 离开 C 点 时 ,将 产生 TouchUp 事件 。 可 见 , 无 论 手指 在 屏幕 上 如 何 
移动 ,TouchDown 和 TouchUp 事件 只 在 手指 触 碰 到 屏幕 和 离开 屏幕 时 产生 。 如 果 手 指 
的 触 碰 点 和 抬 起 点 是 同一 点 ,将 引发 Touched 事件 ;而 如 果 和 手指 在 屏幕 上 移动 了 ,就 不 会 
引发 Touched 事件 。TouchDown 事件 .TouchUp 事件 和 Touched 事件 可 以 为 用 户 提 供 
触 碰 点 的 坐标 ,有 一 个 需要 注意 的 事情 ,TouchUp 提供 的 坐标 点 是 手指 按 下 时 的 坐标 ,而 
不 是 手指 抬 起 时 的 坐标 。 

Dragged 事件 在 手指 移动 过 程 中 持续 产生 ,主要 用 来 跟踪 手指 的 移动 轨迹 。Dragged 
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A (StartX, StartY) 


(PrevX, PrevY) 


(CurrentX, CurrentY) 


图 6.6 画布 中 的 二 维 坐标 与 事件 参数 


事件 提供 了 移动 开始 坐标 点 (StartX 和 Start YO .事件 产生 时 的 当前 坐标 点 (CurrentX 和 
CurrentY)、 前 一 个 事件 产生 时 的 坐标 点 (PrevX 和 PrevY) 及 拖 电 的 精灵 控件 
(draggedSprite) 。 以 图 6. 6 所 示 的 场景 为 例 , 如 果 从 A 点 到 C 的 过 程 中 ,只 在 B 点 和 C 
点 产生 了 Dragged 事件 , 则 在 C 点 产生 的 事件 中 ,移动 开始 节点 是 A, 当 前 节点 是 C, 前 一 
个 事件 产生 是 在 B 点 。 

Flung 事件 只 有 手指 在 屏幕 上 快速 划 动 的 [ES 
时 候 才 会 产生 。 同 样 是 从 A # Pr B #J C 的 过 
程 ,如 果 手 指 在 屏幕 上 移动 得 足够 快 , 则 当 手 
指 在 C 点 抬 起 时 ,会 产生 Flung 事件 。Flung 
事件 中 会 提供 划 动 开始 节点 的 坐标 、 划 动 方 
向 速度、 速度 在 X 轴 和 YY 轴 的 分 量 及 快速 滑 
动 的 精灵 控件 (flungSprite) 。 

下 面 设计 一 个 名 为 CanvasEvent 的 示例 ， 
将 画布 支持 的 所 有 事件 都 集中 在 一 起 展示 。 
CanvasEvent 示例 的 运行 界面 如 图 6.7 所 示 ， 
上 方 空白 的 区 域 是 画布 控件 ,可 以 在 画布 上 进 
行 触 碰 、 拖 忠和 划 动 等 操作 ,这 些 操作 所 引发 
的 画布 事件 的 数据 将 显示 在 下 方 的 区 域 中 。 — 所 下 人 yiaoo 

将 画布 的 高 度 设置 为 200 个 像素 .显示 拖 gà 
忠 事 件 和 划 动 事件 的 标签 高 度 设置 为 60 个 像 
素 ,显示 其 他 3 个 事件 的 标签 高 度 设 置 为 40 
个 像素 ,如 图 6. 8 所 示 。 图 6.7 CanvasEvent 示例 运行 界面 


EaR: 
startX:133.0 startY:130.0 prevX:291.0 prevY:96.0 
rrentX : 299.0 currentY : 91.0 


划 动 事件 : 
33.0,130.0 speed : 0.86489 heading : 27.16866 
vel : 0.76947 yvel : -0.39492 


Viewer Components 

[EJ Display hidden components in Viewer 9 M screeni 
¿canvas 
Daban 
图 tabu2 
Dravas 
 Altabel4 
Lavas 

| 拓 奥 事件 数据 显示 区 域 

划 动 事件 数据 显示 区 十 

| 按 下 事件 数据 显示 区 域 

| 持 起 事件 数据 显示 区 场 

= Rename | Delete 
Media 
Upload File 


6.8  CanvasEvent 示例 界面 设计 


CanvasEvent 示例 的 逻辑 部 分 也 较为 简单 ,就 是 在 每 个 事件 的 响应 函数 中 ,将 事件 提 


供 的 数据 格式 化 为 


Em pn 


when k 


图 6.10 TouchDown 事件 和 TouchUp 事件 


-个 字符 串 显 示 在 界面 中 的 固定 位 置 上 ,如 图 6.9 一 图 6. 11 所 示 。 
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Lu Canvas! + EECC] 
[x 
PE uo NT NE 


do 


图 6.11 Touched 事件 


6.1.3 相机 与 加 速度 传感器 


在 介绍 “画图 板 ” 示 例 之 前 , 先 来 说 明 一 下 如 何 使 用 手机 的 相机 和 加 速度 传感器 。 

相机 控件 是 一 个 非 可 视 化 控件 ,可 利用 手机 的 镜头 进行 拍照 。 相 机 控件 在 媒体 控件 
区 (Media) 可 以 找到 ,如 图 6. 12 所 示 。 

相机 控件 只 支持 TakePicture 一 种 方法 ,如 图 6. 13 所 示 。 此 方法 被 调用 时 ,手机 将 


进行 拍照 。 该 方法 结束 后 会 引发 AfterPictures 事件 。 


AfterPicture 事件 在 拍照 完成 后 产生 ,如 图 6. 14 所 示 ,其 中 image 是 手机 中 存放 拍摄 
的 照片 的 路 径 信息 。 


Media 


È Camcorder 


ImagePicker 
Player 

Sound 
SoundRecorder 
SpeechRecognizer 
TextToSpeech 


VideoPlayer 


m gee z V s 


D 


9 


Camera1 


图 6.12 相机 控件 


TakePicture 


图 6.13 TakePicture 方法 


when AfterPicture 


图 6.14 AfterPictures 事件 


加 速 传 感 器 控件 用 来 检测 手机 加 速度 ,可 在 3 个 方向 测量 手机 晃动 时 的 加 速度 ,测量 
单位 为 米 / 秒 "(m/s: )。 加 速 传 感 器 控件 在 传感器 控件 区 (Sensors) 可 以 找到 ,如 图 6. 15 


所 示 。 


加 速 传感器 控件 支持 X 加 速度 、Y 加 速度 、Z 加 速度 ,每 个 加 速度 数值 都 有 正 值 和 负 
值 ,这 类 似 于 坐标 系 中 数 轴 上 的 数值 。 设 备 处 于 水 平 位 置 向 右倾 斜 , 即 设备 左 侧 抬 高 时 ， 
X 加 速度 数值 为 正 值 ; 反 之 ,设备 向 左倾 斜 , 即 右 侧 抬 高 时 ,X 加 速度 数值 为 负 值 。 手 机 处 


于 水 平 位 置 , 当 下 部 抬 起 时 Y 加 速度 为 正 值 ; 反 之 ,手机 上 部 抬 起 时 Y 加 速度 为 负 值 。 手 
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BarcodeScanner @ 
€  LocationSensor e| 
NearField 9| 
Non-visible components. 
Id orientationSensor @| @ 
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图 6.15 加 速 传感器 控件 


机 处 于 水 平 位 置 , 当 屏 幕 朝 上 时 Z 加 速度 为 正 值 ;屏幕 朝 下 时 Z 加 速度 为 负 值 。 此 外 , 当 
手机 屏幕 朝 上 且 水 平 放 置 时 ,Z 加 速度 约 为 9. 8m/s?。 

加 速 传感器 控件 还 支持 MinimumInterval, Available 和 Enabled 属性 ,属性 的 具体 含 
义 如 表 6.4 所 示 。 


表 6.4 加 速 传感器 控件 的 属性 及 说 明 


m 人 性 说 B 
Available 手机 是 否 具有 加 速 感应 器 件 
Enabled 加 速 感应 器 控件 是 否 可 用 
Minimumlnterval 手机 晃动 的 最 小 间隔 
Sensitivity 用 数字 表示 加 速 器 敏感 程度 ,其 中 ,1 表示 弱 ,2 表示 中 度 ,3 表示 强 
XAccel 水 平 加 速度 
YAccel 垂直 加 速度 
ZAccel 竖 直 方向 


加 速 传 感 器 控件 支持 的 事件 有 AccelerationChanged 和 Shaking, 如 图 6. 16 所 示 。 
AccelerationChanged 事件 在 加 速 传 感 器 的 加 速度 改变 时 调用 ,并 根据 加 速 传感器 的 变化 
返回 X、Y、Z 加 速度 值 ,可 以 在 3 个 方向 上 确定 手机 晃动 时 的 加 速度 大 小 。Shaking 事件 
在 手机 摇晃 时 会 被 多 次 调用 。 


WAcceleroneterSensorl * PEG 


图 6.16 加 速 传感器 控件 的 事件 
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6.1.4 画图 板 示例 


前 文 详细 介绍 了 画布 的 使 用 方法 ,下 面 介 绍 一 个 较为 复杂 的 示例 PaintPic。 在 


PaintPic 示例 中 ,除了 要 用 到 画布 控件 之 外 ， 
还 要 使 用 相机 控件 (Cemera) 和 加 速 传感器 控 
件 (AccelerometerSensor) 。 

PaintPic 示例 主要 实现 画布 功能 ,可 以 利 
用 画笔 在 画布 上 绘制 线条 或 者 圆 形 图 案 , 并 
可 选 不 同 的 画笔 颜色 ,可 以 使 用 “清空 画布 ” 
按钮 或 者 摇晃 手机 的 方式 清空 画布 ,可 以 调 
用 手机 照相 功能 将 所 拍摄 的 图 片 作为 画布 的 
背景 ,并 可 以 将 画布 的 背景 和 绘制 的 图 像 保存 
成 文件 。PaintPic 示例 的 运行 界面 如 图 6. 17 
所 示 。 

PaintPic 示例 中 大 量 使 用 了 按钮 和 水 平 
布局 ,并 且 使 用 了 相机 和 加 速 传感器 两 个 非 可 
视 化 控件 。 这 两 个 控件 在 界面 设计 器 中 可 以 
找到 ,如 图 6. 18 中 编辑 区 最 下 方 的 Camerall 
和 AccelerometerSensorl 分 别 是 相机 和 加 速 
传感器 。 


固形 半径 : | 大 贺 形 
lcd 


meen : aem] 选择 图 片 “| 保存 清空 画 
Blass en zn 


小 贺 形 


6.17 PaintPic 示例 运行 界面 


Display hidden components in Viewer 


Non-visible components 
@ ° 


Accelerometesensorl cameral 


图 6.18 PaintPic 示例 界面 设计 图 
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完成 PaintPic 示例 的 界面 设计 后 ,下面 进行 逻辑 功能 的 设计 。 

逻辑 功能 设计 的 第 一 步 是 定义 一 个 全 局 变量 paintsize, 用 来 表示 绘制 圆 形 图 案 的 半 
径 。 在 Builtcin> Variable 目录 中 获取 全 局 变量 模块 ,将 其 拖 忠 到 编辑 区 后 会 自动 命名 为 
name, WA 6. 19 所 示 。 


Blocks Viewer 


8 Builtin 
corto! 
Hoge 
Wan 
Wes 
Bliss 
Blcoors 
国 Variables 


国 Procedures 


P screen2 
Any component 


图 6.19 获取 全 局 变量 


单 击 全 局 变量 的 名 称 部 分 name, 将 其 更 改 为 paintsize。 再 通过 Built-in > Math 目录 
添加 数值 默认 值 为 0 的 数值 模块 ,然后 将 数值 
更 改 为 4。 将 paintsize 变量 和 数值 模块 组 合 ， 
便 可 将 全 局 变量 paintsize 赋值 为 4, 如 图 6.20 6.20 paintsize 全 局 变量 赋值 
所 示 。paintsize 变量 的 值 为 4, 表示 绘制 圆 形 图 
案 的 半径 为 4 个 像素 。 

逻辑 功能 设计 的 第 二 步 是 响应 “大 圆 形 ?按钮 和 * 小 圆 形 ” 按 钮 的 单 击 事件 。 这 两 个 按 
钮 可 以 控制 绘制 圆 形 图 案 的 半径 大 小 大 圆 形 ”按钮 半径 设置 为 10( 即 paintsize = 10), 
“小 圆 形 ” 按 钮 半径 设置 为 4( 即 paintsize 一 4) ,如 图 6.21 所 示 。 


initialize global 


DNE Buttonbie » Be 


LUE Buttonsmall - fMi! 


do 


ick 


o ES 


图 6.21 “大 圆 形 ” 按 钮 和 * 小 圆 形 ” 按 钮 的 单 击 事件 


逻辑 功能 设计 的 第 三 步 是 响应 画布 的 触 碰 事件 ,也 就 是 在 画布 上 以 paintsize 变量 作 
为 半径 以 触 碰 点 (zx,y) 作 为 中 心 点 绘制 圆 形 图 案 。 

在 Blocks>CanvasDrawing 目录 中 获取 画布 的 触 碰 事件 CanvasDrawing. Touched, 
与 Blocks>CanvasDrawing 目录 中 的 CanvasDrawing. DrawCircle 组 合 。 在 Touched 事 
件 上 部 的 局 部 变量 z 或 y 上 将 鼠标 略 作 停留 ,就 可 以 获取 到 局 部 变量 zx 和 yy, 再 与 
paintsize 全 局 变量 组 合 到 CanvasDrawing. DrawCircle 模块 上 ,这 样 就 完成 了 画布 触 碰 事 
件 的 处 理 ,如 图 6.22 所 示 。 

人 逻辑 功能 设计 的 第 四 步 是 响应 画布 的 拖 忠 事件 ,也 就 是 画布 上 按照 手指 移动 的 轨迹 
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when Touched 


do call 


图 6.22 画布 的 触 碰 事 件 


绘制 线条 。 在 画布 的 拖 蝶 事件 中 ,根据 当前 点 和 前 一 个 点 的 坐标 绘制 直线 ,因为 拖 忠 事件 
的 响应 频率 很 高 ,这 样 在 画面 上 看 就 是 沿 着 手指 移动 形成 的 轨迹 ,而 不 是 由 多 个 点 形成 的 
折线 。 

在 Blocks>CanvasDrawing 目录 中 获取 画布 的 拖 电 事件 CanvasDrawing. Dragged, 
与 Blocks>CanvasDrawing 目录 中 的 CanvasDrawing. DrawLine 组 合 ; 再 获取 4 个 局 部 
变量 prevX prevY , currentX 和 current Y ,并 将 其 组 合 到 CanvasDrawing. DrawLine 模块 
上 ,这 样 就 完成 了 画布 拖 忠 事件 的 处 理 ,如 图 6.23 所 示 。 


when Dragged 


图 6.23 画布 的 拖 搜 事件 


逻辑 功能 设计 的 第 五 步 是 响应 3 个 修改 画笔 颜色 按钮 的 事件 ,而 且 要 在 初始 化 的 时 
候 设 置 画 笔 的 颜色 。 

先 从 Blocks > CanvasDrawing 目录 中 获取 到 控制 画笔 颜色 模块 CanvasDrawing. 
PaintColor ,再 在 Built-in*Colors 目录 中 分 别 获 取 表 示 红 色 、 绿 色 和 蓝 色 的 模块 ,然后 将 
颜色 模块 与 CanvasDrawing. PaintColor 属性 组 合 在 一 起 ,就 可 以 实现 修改 画笔 的 颜色 。 
然后 再 将 这 些 组 合 模块 分 别 与 ButtonRed. Click, ButtonGreen. Click 和 ButtonBlue. 
Click 组 合 , 即 可 完成 响应 画笔 颜色 修改 按钮 的 事件 ,如 图 6. 24 所 示 。 


n Initialize shen CTI Click 


when ENIES .click 


图 6.24 画笔 颜色 修改 按钮 的 事件 
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画笔 的 默认 颜色 为 黑色 ,PaintPic 示例 中 画笔 只 有 红色 、 绿 色 和 蓝 色 可 选 , 这 样 需要 
在 屏幕 页 初始 化 的 时 候 修改 画笔 颜色 ,将 画笔 颜色 修改 为 红色 。 

屏幕 页 初始 化 模块 在 Blocks>Screen] 目录 中 的 Screenl. Initialize 事件 模块 中 ,该 模 
块 会 在 屏幕 页 启动 时 被 调用 ,一 般 用 来 实现 初始 化 控件 的 属性 等 操作 。 

逻辑 功能 设计 的 第 六 步 是 实现 两 种 清空 画布 的 方法 ,一 种 是 单 击 * 清 空 画布 ?按钮 实 
现 , 另 一 种 是 通过 晃动 手机 实现 。 

Blocks—>*CanvasDrawing 目录 中 的 CanvasDrawing. Clear 模块 会 将 画布 上 所 有 画笔 
所 绘制 的 内 容 全 部 清空 ,但 画布 背景 内 容 不 会 有 变化 。 

加 速度 传感器 的 晃动 事件 AccelerometerSensorl. Shaking 在 Blocks 一 
AccelerometerSensorl 目录 中 ,该 事件 在 晃动 手机 时 被 调用 ,将 CanvasDrawing. Clear 模 
块 与 其 组 合 ,就 可 以 在 晃动 手机 时 清空 画布 内 容 , 如 图 6. 25 所 示 。 


when Click E iccslercmererSensorl - BELTS 


图 6.25 画布 清空 逻辑 


逻辑 功能 设计 的 第 七 步 是 实现 画布 背景 更 换 功 能 ,同样 支持 两 种 更 换 方 法 ,一 种 是 单 
击 * 选 中 图 片 "按钮 ,在 手机 的 图 片 库 里 面 选择 画布 背景 ; 另 一 种 是 通过 手机 拍照 ,将 拍摄 
的 图 片 更 换 为 画布 背景 。 

更 换 画 布 背景 图 片 是 通过 修改 Blocks > CanvasDrawing 目录 中 的 CanvasDrawing. 
BackgroundImage 属性 实现 的 ,将 指定 的 图 像 (image) 赋 值 给 BackgroundImage 属性 ,就 
完成 了 画布 背景 的 修改 ,如 图 6. 26 所 示 。 


图 6.26 ”画布 背景 更 换 逻 辑 


除了 从 相机 获取 图 像 以 外 ,还 可 以 从 ImagePicker 获取 背景 图 片 。ImagePicker 的 
AfterPicking 方法 在 用 户 选 择 图 片 后 被 调用 ,该 方法 与 修改 画布 背景 的 模块 组 合 在 一 起 ， 
并 将 ImangePicker. Selection 作为 图 像 参 数 传递 给 BackgroundImage 属性 ,就 可 以 实现 
画布 背景 的 更 改 。 

相机 控件 在 用 户 单 击 ButtonTakepic 按钮 时 调用 TakePicture 方法 拍照 ,在 获取 到 照 
片 后 ,会 立即 调用 AfterPicture 方法 获取 照片 并 蔡 换 原画 布 背 景 。 
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逻辑 功能 设计 的 第 八 步 ,也 是 最 后 一 步 ,就 是 将 画布 内 容 保存 为 文件 。 通 过 调用 
CanvasDrawing. Save 方 法 ,可 以 直接 将 画布 内 容 保存 到 手机 的 SD 卡 中 ,并 将 该 方法 返 


回 的 文件 路 径 传递 给 LabelSaveStatus. Text 属性 ,如 图 6. 27 所 示 ,将 其 显示 在 界面 的 最 
Fs 


be ButtonSave - BST 


do. set 


图 6.27 画布 内 容 保存 为 文件 


将 上 述 逻 辑 模 块 添加 完成 后 ,模块 编辑 器 中 的 全 部 逻辑 功能 如 图 6. 28 所 示 。 


e ll iccelercneterSensorl Hr 
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图 6.28 PaintPic 示例 的 全 部 逻辑 模块 


PaintPic 示例 在 手机 上 的 运行 结果 如 图 6.29 所 示 。 在 模拟 器 上 运行 该 示例 ,不 能 够 
实现 使 用 手机 拍照 和 通过 晃动 手机 清空 画布 功能 。 
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storage/sdcard0/My Te 
ipp inventor 1363533529151.png 


图 6.29 PaintPic 示例 在 手机 上 的 运行 效果 图 


62 图 像 精灵 


6.2.1 精灵 使 用 


ImageSprite( 图 像 精灵 ) 是 一 种 可 在 画布 中 自由 移动 的 图 像 , 并 可 与 球体 (Ball) .其 他 
图 像 精 录 和 画布 边缘 产生 碰撞 效果 ,因此 经 常用 于 游戏 开发 ,如 图 6. 30 所 示 。 


图 6.30 游戏 中 的 精灵 


图 像 精 灵 是 AI2 在 游戏 制作 中 经 常 使 用 的 控件 ,放置 在 绘图 和 动画 子 类 中 ,如 图 6. 31 
所 示 。 
画布 上 的 图 像 精灵 可 以 响应 触摸 、 划 动 或 拖 忠 等 操作 ,如 果 设 置 精灵 自身 关于 运动 的 
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一 些 属性 ,精灵 则 可 


以 按照 预定 的 方式 移动 。 例 如 ,为 实现 一 个 图 像 精 灵 每 隔 1000ms 向 


左 侧 移动 10 像素 , 则 可 以 设置 其 Speed( 速 度 ) 属 性 值 为 10 像素 ,Interval( 时 间 间 隔 ) 属 性 
为 1000ms,Heading( 方 向 ) 属 性 设置 为 180,Enabled( 激 活 ) 属 性 设置 为 True。 勾 选 精灵 
的 旋转 属性 (Rotates) 时 ,图 片 会 根据 精灵 的 朝向 变化 进行 转动 ,设置 好 的 参数 如 图 6. 32 


所 示 。 
Enabled 
m 
Heading —  — 
180 
Interval 
1000 
Picture 
None... 
Rotates 
| Drawing and Animation m 
£ Bal @ — 
10 
ËB Canvas @ — TI m 
Visible 
m 
图 6.31 绘图 和 动画 子 类 中 的 图 像 精 灵 图 6.32 精灵 控件 属性 设置 


图 像 精灵 支持 的 属性 如 表 6.5 所 示 。 其 中 ,属性 Picture 需要 指定 一 个 图 片 ,是 精灵 
显示 在 画布 上 的 图 像 。 属 性 Rotates 表示 是 否 允许 精灵 旋转 ,如 果 允 许 ,图 像 精灵 在 改变 


移动 方向 (Heading) 时 ,图 片 会 自动 旋转 以 匹配 新 的 移动 方向 。 
表 6.5 图 像 精灵 的 属性 及 说 明 

属性 说 明 

Enabled 是 否 激活 

Heading 移动 方向 

Height 图 片 高 度 

Interval 移动 频率 

Picture 精灵 图 片 

Rotates 是 否 允许 精灵 旋转 

Speed 移动 速度 

Visible 是 否 可 见 

Width 图 片 宽度 

x 所 在 位 置 横 坐标 

Y 所 在 位 置 纵 坐标 

2 图 层 较 高 的 精灵 控件 所 在 层 数 与 图 层 较 低 的 精灵 控件 所 在 层 数 之 差 
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X 和 YY 是 图 像 精灵 在 画布 上 的 坐标 ,X 为 0 时 ,表示 图 像 精灵 已 经 到 达 画 布 的 左 侧 
边界 ;Y 为 0 时 , 则 表示 图 像 精灵 已 经 到 达 画 布 的 上 边界 。Enabled 属性 表示 图 像 精 灵 是 
否 会 被 激活 ,如 果 精 灵 与 移动 相关 的 属性 被 设置 ,同时 Enabled 为 true, 则 图 像 精 灵 会 在 
画布 上 移动 。Visible 属性 决定 了 图 像 精灵 在 画布 上 是 否 可 见 。 

属性 Heading 是 图 像 精 灵 的 移动 方向 , 取 值 范围 是 0 一 360, 其 中 ,0 表示 水 平 向 右 ， 
90 代表 垂直 向 上 ,180 代表 水 平 向 左 ,270 表示 垂直 向 下 ,如 图 6. 33 所 示 。 

图 像 精 灵 支 持 的 事件 包括 碰撞 事件 (CollidedWith) , Hi 8 38 f (Dragged) , fh 8E 3 fF 
(EdgeReached) 不 再 碰撞 事件 (NoLongerCollidingWith) il fj if $ f/- ( Touched) 47 , i% HH 
如 表 6.6 所 示 。 


表 6.6 图 像 精灵 的 事件 及 说 明 


事件 说 — H 
CollidedWith 碰撞 事件 
EdgeReached 触 壁 事件 
NoLongerColliding With 不 再 碰撞 事件 
8 «—— Heading — ° Touched 触 碰 事件 
| Dagga mm 
Flung 划 动 事件 
TouchUp 抬 起 事件 
图 6.33 ”精灵 朝向 数值 代表 含义 ts Erat 


图 像 精灵 的 事件 模块 如 图 6.34 所 示 。 碰 撞 事 件 ,不 再 碰撞 事件 和 和 触 壁 事件 属于 碰撞 
检测 事件 ,这 部 分 内 容 将 在 “高 级 动画 功能 ”小 节 内 容 中 介绍 。 


bn ImageSpritel - 1: 


when TouchUp 


kasa -Flung 


图 6.34 图 像 精 灵 的 事件 


图 像 精灵 支持 精灵 的 移动 .反弹 和 碰撞 检测 方法 ,如 表 6.7 和 图 6. 35 所 示 。 
Bounce 方法 调用 后 ,图 像 精灵 会 根据 参数 edge 计算 碰撞 后 下 一 步 的 运动 方向 。 这 
个 方法 经 常 在 图 像 像 精灵 与 墙壁 碰撞 的 时 候 使 用 。 
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表 6.7 图 像 精灵 的 方法 及 说 明 


i P> # 说 明 

Bounce 精灵 从 边缘 反弹 

' ColldingWith 检测 精灵 是 否 碰撞 

' MovelntoBounds 精灵 超出 边界 时 将 精灵 移 至 边界 内 

MoveTo 将 精灵 移动 到 指定 坐标 点 
PointTowards 将 移动 方向 朝向 另 一 个 精灵 
PointInDirection 将 移动 方向 朝向 指定 坐标 点 


PHI .Poi 


6.35 精灵 的 方法 


ColldingWith 方法 用 来 检测 图 像 精 灵 是 否 发 生 碰 撞 ,返回 值 为 布尔 函数 值 。 当 返回 
值 为 true 时 ,说 明 与 指定 精灵 或 画布 边缘 发 生 碰 撞 ; 返 回 值 为 false 时 , 则 未 发 生 碰撞 。 
MoveIntoBounds 方法 是 将 超出 边缘 的 控件 重新 移动 至 画布 边缘 范围 内 。 


6.2.2 打 地 鼠 示 例 


该 游戏 示例 是 经 典 的 “ 打 地 鼠 ” 游 戏 , 女 鼠 在 5 个 洞 中 随机 出 现 ,但 出 现 的 时 间 非 常 短 
暂 , 因 此 要 集中 精力 快速 单 击 洞口 的 届 鼠 ,每 次 成 功 单 击 导 鼠 即 得 1 分 ,积累 到 10 分 则 游 
戏 胜利 。 该 游戏 示例 的 运行 界面 如 图 6. 36 所 示 。 
单 击 Play 按钮 开始 游戏 , 候 鼠 会 随机 出 现在 某 个 洞口 ,每 次 击 中 峰 鼠 将 会 产生 一 次 
震动 反馈 ,同时 “分 数 ” 加 1。 在 游戏 进行 中 ,如 果 用 户 单 击 Reset 按钮 ,分 数 将 清 零 , 重 新 
单 击 Play 按钮 后 重新 开始 游戏 。 游 戏 积累 到 10 分 后 ,将 出 现 * 蔡 喜 你 ,你 赢 了 ! 的 游戏 


胜利 提示 ,并 发 出 “ 叮 响声 音 ,如 图 6.37 所 示 。 


在 Mole 示例 的 资源 中 共有 5 个 图 片 文件 和 一 个 声音 文件 ,这 些 资源 都 是 游戏 中 不 


可 缺少 的 ,资源 的 说 明 如 表 6. 8 所 示 。 


表 6.8 资源 文件 说 明 


x —w* 说 明 x d 说 明 
PlayButton. png “Play” 按 钮 图 片 hole. png 洞口 精灵 的 图 片 
ResetButton. png “Reset” 按 钮 图 片 mole. png RE RUE RU EDT 
grass. jbg Canvas 画布 的 背景 图 片 DingDong. mp3 游戏 获胜 的 “ 叮 吃 "声音 


BOE, UNT! 
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H 6.36 Mole 示例 的 运行 界面 图 6.37 游戏 获胜 画面 


Mole 示例 的 界面 设计 如 图 6. 38 所 示 。 时 钟 ClockMole 控制 着 届 鼠 精灵 的 周期 性 移 
动 ,因此 设置 ClockMole 时 钟 的 Enable 属性 为 false ,控制 时 钟 在 用 户 单 击 Play 按钮 后 再 
启动 。 设 置 时 间 间 隔 (CTimerInterval) 为 10000ms(10s) ,TimeAlwaysFires 设置 为 true, 


Non visible components 


图 6.38 Mole 示例 的 界面 设计 图 
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将 声音 控件 Sound 的 Source 属性 设置 为 已 经 上 传 的 DingDong. mp3 文件 ,用 户 也 可 
以 选择 自己 喜欢 的 音频 ,但 需要 控制 上 传 文件 的 大 小 。 将 标签 LabelWin 的 Enable 属性 
设 为 false, 在 用 户 游戏 胜利 时 显示 该 标签 内 容 。 

在 模块 编辑 器 中 ,首先 定义 两 个 全 局 变量 holes 和 currentHole, 如 图 6. 39 所 示 。 
Holes 是 表示 洞口 图 像 精灵 的 列表 ,在 定义 时 先 调用 create empty list 方法 获得 一 个 空 列 
表 , 在 屏幕 页 初始 化 时 动态 添加 元 素 。currentHole 表示 当前 洞口 的 图 像 精灵 ,在 自 定义 
的 MoveMole 函数 中 使 用 。 


initialize 


initialize ] o create empty list 
图 6.39 定义 全 局 变量 


如 图 6.40 所 示 ,屏幕 页 的 初始 化 事件 完成 了 三 项 工作 ,一 是 初始 化 5 个 表示 洞口 的 
图 像 精 灵 的 Picture 属性 ;二 是 设置 时 钟 ClockMole 的 TimeEnabled 属性 为 false; 三 是 设 
置 图 像 精 录 Mole 的 Enabled 属性 为 false。 


LUE Screen] 国人 Et 

do add items to list list ge 
item 
De M Hole? -] 
iten 
item 


iten 


of component 


图 6.40 屏幕 页 Screenl 的 Initialize 事件 


虽然 在 界面 编辑 器 中 已 经 设置 了 时 钟 ClockMole 的 TimeEnabled 属性 为 false, 为 了 
避免 误 操 作 引 起 逻辑 错误 ,仍然 在 屏幕 页 的 初始 化 事件 中 再 次 对 该 属性 进行 设置 。 设 置 
图 像 精 灵 Mole 的 Enabled 属性 为 false, 可 以 让 图 像 精 灵 暂 时 不 接受 单 击 (Touched) 事 
件 ,避免 游戏 还 没有 正式 开始 前 ,用 户 已 经 可 以 开始 通过 单 击 假 鼠 获得 游戏 分 数 。 

表示 起 鼠 的 图 像 精 灵 Mole 的 属性 Enabled 的 逻辑 与 时 钟 ClockMole 是 一 样 的 ,也 
是 在 用 户 单 击 Play 按钮 后 允许 用 户 单 击 (true) ,在 单 击 Reset 按钮 后 变 为 不 可 单 击 
(false) 。 

初始 化 图 像 精 灵 Holel 到 Hole5 有 两 种 方法 ,一 是 在 界面 编辑 器 中 设置 其 Picture 


第 6 章 游戏 开发 


属性 为 上 传 文件 hole. png; 二 是 在 屏幕 页 初始 化 函数 中 动态 修改 Holel 到 Hole5 的 
Picture 属性 。 本 示例 使 用 的 是 第 二 种 方法 ,此 方法 略 显 烦琐 ,但 却 演 示 了 一 种 动态 的 批 
量 修改 图 像 精灵 属性 的 方法 。 

这 里 用 到 了 Block Any component > Any ImangeSprite 目录 中 的 ImageSprite. 
Picture 模块 ,如 图 6.41 所 示 。Any component 区 的 模块 可 以 对 所 有 同类 型 的 控件 进行 
操作 ,比如 修改 所 有 标签 的 文字 、 修 改 所 有 按钮 的 颜色 等 。 

ImageSprite. Picture 模块 如 图 6. 42 FH 28. H component 用 来 拼接 图 像 精 灵 
(ImageSprite) Bi . Bi to 用 来 拼接 图 片 (Picture) 属 性 。Advanced 区 的 其 他 模块 有 着 与 
ImageSprite. Picture 模块 相似 的 结构 和 模 , 可 以 分 别 拼 接 各 自 支 持 的 控件 类 型 和 属性 。 

全 局 变量 holes 的 初始 化 是 通过 调用 Built-in—> Lists 目录 中 add items to list 方法 实 
现 的 ,其 将 所 有 表示 洞口 的 图 像 精灵 控件 加 载 到 全 局 变量 holes 中 ,如 图 6. 43 所 示 。 


© Any component 


国 Any Button 

UB ny Canvas 

Y Any Clock add items to list list 
Bany HorizontalArrangen item 
2 Ex item 
[A] Any Label dics 
@ Any sound item 
Bany TableArrangement aten 

图 6.41 Any component 区 的 模块 图 6.43 初始 化 holes 列表 


在 foreach 循环 中 ,调用 ImageSprite. Picture 模块 ,将 每 个 表示 洞口 图 像 精 灵 的 
Picture 属性 都 赋值 为 hone. png, 如 图 6.44 所 示 。 


for each in list lot 


do. set ImageSprite. 


of 


component 


图 6.44 循环 调用 ImageSprite. Picture 模块 


为 了 重复 利用 已 有 代码 ,可 以 将 侨 鼠 的 移动 做 成 郴 数 MoveMole, 这 个 函数 将 由 鼠 的 
图 像 精 灵 随 机 出 现在 五 个 洞口 中 的 任意 一 个 ,逻辑 模块 如 图 6. 45 所 示 。 在 MoveMole PR 
数 中 ,首先 调用 pick a random itemlist 方法 在 hones 列表 中 随机 选取 一 个 图 像 精 灵 赋 值 
给 全 局 变量 current Hole. #Ë J i8] FIR ER ERAR Mole 的 MoveTo 方法 将 currentHole 
中 图 像 精灵 的 坐标 X 和 坐标 Y 作为 参数 传递 给 Move To 方法 ,这 样 就 可 以 将 距 鼠 图 像 精 
灵 移 动 到 全 局 变量 currentHole 所 代表 的 洞 上 面 。 
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pick a random itemlist 


图 6.45 MoveMole 函数 


在 时 钟 ClockMole 的 触发 事件 中 只 调用 MoveMole 函数 移动 表示 侨 鼠 的 图 像 精 灵 ， 
如 图 6. 46 所 示 。 在 游戏 初始 化 阶段 ,ClockMole 时 钟 是 不 运行 的 ,只 有 用 户 单 击 Play f 
钮 后 ,ClockMole 时 钟 才 开始 运行 ; 单 击 Reset 按钮 ,或 者 用 户 游戏 胜利 后 ,时钟 
ClockMole 又 变 为 不 运行 状态 。 

图 6.47 所 示 的 两 个 按钮 事件 还 实现 了 分 数 归 零 和 隐藏 胜利 信息 等 功能 。 


LiG ButtonReset Jiubrt23 


6.46 MoveClock 时 钟 的 Timer 方法 图 6.47 ”两 个 按钮 单 击 事件 


游戏 启动 后 ,时 钟 ClockMole 要 在 一 个 周期 以 后 才 会 触发 ,在 触发 事件 中 眉 鼠 才 会 
移动 。 为 了 在 游戏 启动 后 立即 产生 急 鼠 移动 的 效果 ,要 在 ButtonStart 按钮 的 单 击 事件 中 
主动 调用 MoveMole 函数 ,完成 月 鼠 的 一 次 移动 ,如 图 6. 48 所 示 。 

在 图 像 精灵 Mole 的 Touched 事件 中 ,用 户 每 次 触 碰 精灵 ,都 要 调用 一 次 MoveMole 
函数 ,移动 一 次 馒 鼠 ,并 发 出 震动 反馈 (Sound. Vibrate)。 如 果 游 戏 分 数 (LabelValue. 
Text) 小 于 10, 则 每 次 触 碰 都 会 将 游戏 分 数 增加 1。 如 果 游 戏 分 数 已 经 大 于 等 于 10, 则 游 
戏 结束 ,发 出 游戏 胜利 的 音效 (Sound. Play) ,停止 时 钟 (ClockMole) . fd RE fI (fii o6 
效 (Enabled 为 false) ,并 显示 游戏 胜利 的 消息 (LableWin. Visible 为 true). 

Mole 示例 的 全 部 逻辑 模块 如 图 6. 49 所 示 。 
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when (OU . Touche 


e 


add items to list 


component || get (ICES 


图 6.49 Mole 示例 的 全 部 逻辑 模块 
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63 高 级 动画 功能 
6.3.1 碰撞 检测 


碰撞 检测 是 在 精灵 的 运动 过 程 中 ,检测 到 精灵 自身 边缘 与 其 他 精灵 或 画布 边缘 接触 
的 技术 ,在 开发 游戏 过 程 中 经 常用 到 。 

图 6. 50 所 示 是 愤怒 的 小 鸟 的 游戏 截图 ,这 其 中 就 大 量 使 用 了 碰撞 检测 技术 。 例 如 小 
鸟 在 飞行 过 程 中 碰撞 到 石 块 时 ,小 鸟 和 石 块 都 要 有 相应 的 反应 ,小 鸟 会 弹 回 去 , 石 块 会 裂 
开 。 再 例如 两 个 落 在 一 起 的 小 猪 , 上 方 的 小 猪 和 下 方 的 小 猪 只 可 以 边界 互相 接触 ,而 不 能 
够 重合 。 


图 6.50 愤怒 的 小 乌 游 戏 画面 


碰撞 检测 技术 的 实现 要 运用 数学 和 物理 知识 ,在 不 同 的 情况 下 采用 不 同 的 碰撞 检测 
方式 ,本 节 主 要 介绍 碰撞 检测 的 基本 原则 和 使 用 方式 。 

- 般 情况 下 ,只 有 游戏 中 的 物体 发 生 移 动 后 才 有 必要 进行 碰撞 检测 ,所 以 碰撞 检测 的 
流程 分 为 更 新 物体 位 置 .进行 碰撞 检测 、 碰 撞 处 理 三 步 。 

实现 碰撞 检测 通常 包括 3 个 方面 的 内 容 。 首 先 ,确定 检测 对 象 。 游 戏 在 运行 中 会 有 
很 多 实体 对 象 ,在 进行 碰撞 检测 时 并 不 需要 对 所 有 实体 对 象 都 检测 一 遍 , 如 静止 的 宝箱 没 
有 必要 去 检测 和 另外 的 宝箱 是 否 发 生 了 碰撞 。 所 以 在 开始 碰撞 检测 之 前 ,首先 要 确定 碰 
撞 检测 的 对 象 是 什么 。 其 次 ,检测 是 否 碰撞 ,这 是 检测 的 核心 环节 。 在 这 个 环节 需要 综合 
考虑 游戏 本 身 的 需求 ,以 及 运行 平台 的 性 能 等 问题 ,合理 选择 碰撞 检测 的 算法 。 最 后 是 处 
理 碰 撞 。 当 检测 到 碰撞 发 生 的 时 候 ,就 需要 根据 碰撞 的 类 型 进行 相应 的 处 理 , 例 如 炮弹 会 
在 碰 到 目标 后 爆炸 ,并 给 目标 带 来 伤害 。 


6.3.2 球体 的 使 用 


球体 (Ball) 是 特殊 的 图 像 精灵 ,具有 与 图 像 精灵 相似 的 属性 及 完全 相同 的 事件 和 方 
法 ,如 图 6. 51 所 示 。 不 同 之 处 在 于 球体 不 能 够 有 自 定义 的 外 观 ,但 可 以 改变 球体 的 大 小 
和 颜色 。 

球体 的 属性 包括 球体 大 小 .颜色 、 移 动 频率 、 移 动 方向 和 移动 速度 等 ,所 有 属性 如 
表 6.9 所 示 。 
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图 6.51 球体 控件 
表 6.9 球体 的 属性 及 说 明 


属 ”性 说 m | 
Radius 球 的 半径 
PaintColor 球体 颜色 
Enabled 是 否 启动 球体 
Interval 球体 移动 频率 
Visible 球体 是 否 可 见 
Heading 球体 移动 方向 
Speed 球体 移动 速度 
x 球体 控件 最 左 侧 边界 的 坐标 ,向 右 运动 ,数值 增加 
Y 球体 控件 最 上 方 边界 的 坐标 ,向 下 运动 ,数值 增加 
z 图 层 较 高 的 球体 控件 相对 于 其 他 图 层 较 低 的 球体 控件 的 层 数 


球体 与 图 像 精 灵 具 有 相同 的 事件 和 方法 ,下 面 的 内 容 主 要 介绍 与 碰撞 检测 相关 的 事 
件 和 方法 。 球 体 中 与 碰撞 检测 相关 的 事件 有 碰撞 事件 (CollidedWith)、 不 再 碰撞 事件 
(NoLongerColliding With) 和 触 壁 事件 (EdgeReached) 。 

碰撞 事件 是 当前 图 像 精 灵 与 其 他 精灵 或 画布 边缘 
发 生 碰撞 时 产生 的 事件 ,该 事件 的 参数 other 是 被 碰撞 
的 精灵 ,如 图 6.52 所 示 。 

不 再 碰撞 事件 是 当前 精灵 与 已 经 产生 碰撞 的 精灵 6.52 球体 的 碰撞 事件 
分 开 时 产生 的 事件 ,是 碰撞 事件 的 对 立 事件 。 当 两 个 精 
灵 产 生 碰撞 时 , 先 发 生 的 是 碰撞 事件 ,如 果 两 个 精灵 被 弹 开 , 随 即便 会 产生 不 再 碰撞 事件 。 
该 事件 的 参数 other 是 被 碰撞 的 精灵 ,如 图 6. 53 所 示 。 

触 壁 事件 在 图 像 精 灵 移 动 到 画布 边缘 时 发 生 。 当 一 个 精灵 运动 到 画布 边缘 时 , 则 会 
产生 触 壁 事件 ,如果 不 对 此 事件 做 任何 处 理 , 精 灵 则 会 移动 出 画布 边界 ;相反 ,如 果 在 触 壁 
事件 中 将 精灵 的 运动 方向 逆转 , 则 精灵 又 会 重新 回 到 画布 中 ,如 图 6.54 所 示 。 


alll ， .CollidedWith 


LIE Balll + BRUGES SV EET HT usd DGE Balll + BLOEI 


图 6.53 球体 的 不 再 碰撞 事件 图 6.54 球体 的 触 壁 事 件 
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触 壁 事件 的 参数 edge 表示 所 到 达 的 画布 边缘 ,可 用 数字 表示 画布 不 同 的 边缘 ,如 
图 6. 55 所 示 ,1 表示 上 方 (north) ,2 表示 右上 (northeast) ,3 X di fill eas ,4 KRAF 
(southeast) ,一 1 表示 下 方 (south) ,一 2 表示 左下 方 (southwest) ,一 3 € zi Ze M (west), 
一 4 表示 左上 方 (northwest) 。 

在 球体 的 方法 中 ,最 常用 的 就 是 Bounce 方法 ,与 EdgeReached 事件 配合 使 用 可 将 球 
体 从 画布 边缘 反弹 回 画 布 中 。 当 EdgeReached 事件 检测 到 碰撞 后 ,调用 Bounce 方法 ,并 
将 EdgeReached 事件 检测 到 的 碰撞 边缘 Edge 参数 传递 给 Bounce 方法 ,精灵 可 以 根据 此 
参数 进行 边缘 反弹 ,如 图 6. 56 所 示 。 


DIE Balll + Bb) 


do 


Bounce 


edge 


图 6.55 画布 边缘 信息 含义 图 6.56 边缘 检测 事件 逻辑 模块 


6.3.3 方向 传感器 


在 介绍 "乒乓 球 ” 示 例 之 前 , 先 来 说 明 一 下 如 何 使 用 手机 的 方向 传感器 。 方 向 传感器 
控件 (OrientationSensor) 是 一 个 非 可 视 化 控件 ,可 用 来 测定 手机 的 三 轴 角 度 的 变化 。 界 
面 编辑 器 中 的 方向 传感器 控件 如 图 6. 57 所 示 。 

将 手机 正面 向 上 放置 在 水 平 桌面 上 , 沿 手机 屏幕 水 平方 向 (左右 ) 定 义 为 X 轴 , 水 平 
方向 (后 前 ) 定 义 为 Y 轴 ,垂直 于 手机 屏幕 的 方向 (上 下 ) 定 义 为 Z 轴 ,如 图 6.58 所 示 。 


Sensors 
e AccelerometerSensor 
BarcodeScanner 


[] LocationSensor 


NearField 


Non-visible components 
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图 6.57 方向 传感器 图 6.58 手机 3 个 维度 示意 图 
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方向 传感器 可 以 反馈 Roll, Pitch 和 Azimuth 共 3 个 数据 ,数据 单位 是 度 , 且 有 正 负 
es 

Roll 表示 手机 x 轴 与 水 平面 的 夹 角 , 范 围 为 一 90 一 90, 手 机 处 于 水 平 放 置 时 数值 为 
0, 向 左 侧 倾斜 时 数值 由 0 递增 到 90, 向 右倾 斜 时 数值 由 0 递减 至 一 90。Pitch 表示 手机 
y 轴 与 水 平面 的 夹 角 ,范围 为 一 90 一 90, 手 机 水 平 放置 时 为 0,y 轴 正 方向 朝 下 倾斜 时 数值 
H 0 增加 到 90,y 轴 正 方向 朝 上 倾斜 时 数值 由 0 递减 至 一 90。Azimuth 表示 方位 ,是 手机 
水 平 放置 时 磁 北 极 和 y 轴 的 夹 角 , 范 围 为 0 一 360,y 轴 正 方向 指向 正 北 时 为 0, 指 向 正 东 
为 90 ,指向 正 南 为 180 ,指向 西 东 为 270。 

方向 传感器 控件 通过 相关 属性 ,包括 方向 传感器 的 启动 .方位 角 和 设备 翻转 大 小 等 ， 
来 确定 设备 的 方向 改变 ,如 表 6. 10 所 示 。 


表 6.10 方向 传感器 属性 及 说 明 


属 性 说 明 属 性 说 明 
Available 方向 传感器 是 否 可 用 Roll 水 平 转动 角度 
Enabled 启用 方向 传感器 Magnitude 倾斜 程度 
Azimuth 方位 角 Angle 倾斜 角 

Pitch 垂直 翻转 角度 


Magnitude 表示 手机 的 倾斜 程度 ,是 一 个 0 一 1 之 间 的 数 。Angle 表示 倾斜 角 大 小 。 

方向 传感器 只 有 OrientationChanged 一 个 事件 ,如 图 6. 59 所 示 , 在 手机 方向 发 生变 
化 时 产生 ,返回 Roll, Pitch 和 Azimuth 数据 。 即 使 静止 放置 在 水 平面 上 ,手机 方向 传 感 
器 仍然 能 够 检测 到 微小 的 方向 变化 ,所 以 可 以 认为 OrientationChanged 事件 是 持续 发 生 
的 事件 ,事件 中 的 处 理 过 程 务必 要 简单 、 高 效 。 

下 面 通过 Orientation 示例 帮助 读者 使 用 自己 的 手机 感受 如 何 使 用 方向 传感器 ,并 分 
Pr Roll、Pitch 和 Azimuth 数据 的 具体 含义 。Orientation 示例 的 运行 界面 如 图 6. 60 所 
示 , 界 面 设 计 图 如 图 6. 61 所 示 。 

Orientation 


方向 传感器 三 轴 姿态 数值 


-0.44107 
Y 轴 : Roll 
-2.75778 

Z 轴 : Azimuth 
79.32386 


F9.08674 
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图 6.59 方向 传感器 的 OrientationChanged 事件 图 6. 60 Orientation 示例 的 运行 界面 
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6.61 Orientation 示例 界面 设计 图 


Orientation 示例 的 全 部 逻辑 模块 如 图 6. 62 所 示 。 


bt OrientationSensorl ~ 用 


do 


hanged 


6.62 Orientation 示例 的 全 部 逻辑 模块 


6.3.4 乒乓 球 示例 


“乒乓 球 ” 游 戏 中 的 小 球 会 向 画面 下 方 以 一 定 角 
度 掉 落 , 用 户 通 过 控制 画面 下 方 的 球 板 , 阻 止 小 球 落 
到 地 面 上 。 小 球 碰 到 球 板 后 会 弹 起 ,每 次 接触 球 板 
都 会 得 1 分 。 游 戏 中 用 户 可 以 使 用 触 碰 屏幕 的 方法 
控制 球 板 , 也 可 以 使 用 方向 传感器 控制 球 板 。 

Pong 示例 使 用 的 控件 有 球体 、 图 像 精灵 、 画 布 、 
方向 传感器 、 音 效 播放 器 以 及 常见 的 按钮 .标签 和 复 
选 框 等 控件 。Pong 示例 的 运行 界面 如 图 6. 63 所 示 。 

将 游戏 需要 的 所 有 资源 文件 上 传 到 AI2 中 , 包 
括 Play 按钮 的 背景 图 片 PlayButton. png. Reset 按 
钮 的 背景 图 片 ResetButton. png、 夯 布 的 背景 图 片 
background. png\ 球 板 图 像 精灵 的 图 片 Paddle. png 
和 失败 声效 文件 DingDong. mp3。 


=i 
[esses 


图 6.63 Pong 示例 的 运行 界面 
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游戏 是 纵向 设计 的 ,这 里 关闭 手机 的 屏幕 旋转 功能 ,将 Screenl 的 ScreenOrientation 
属性 设置 为 Portrait ,将 音效 播放 器 的 Source 属性 设置 为 DingDong. mp3 ,还 要 将 球体 的 | 
初始 位 置 设置 为 (20,20), 即 属性 X 为 20,Y 属性 为 20, 球 体 的 半径 (Radius) 也 设置 为 | 
20, 完 成 界面 设计 ,如 图 6.64 所 示 。 i 
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图 6.64 Pong 示例 的 界面 设计 图 


在 完成 界面 设计 的 工作 后 ,开始 程序 的 逻辑 设计 部 分 。 如 图 6. 65 Bros ,首先 在 屏幕 
页 的 Initialize 事件 中 将 球体 Enabled 属性 设置 为 false, 避 免 球体 在 没有 正式 开始 游戏 前 
移动 ;还 要 将 方向 传感器 的 Enabled 属性 设置 为 false, 用 户 手 动 勾 选 “传感器 控制 " 复 选 
框 后 才 可 以 启动 传感器 。 


when GEAD . Initialize 


CN 


图 6.65 屏幕 页 的 Initialize 事件 


“传感器 控制 " 复 选 框 的 Changed 事件 的 逻辑 如 图 6. 66 所 示 。 在 每 次 复 选 框 修改 事 
件 中 判断 复 选 框 的 状态 ,如 果 复 选 框 被 选中 , 则 启动 方向 传感器 ,否则 就 关闭 方向 传感器 。 
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Hi6.66 复 选 框 的 Changed 事件 


使 用 方向 传感器 控制 球 板 是 一 个 不 错 的 选择 ,这 样 用 户 就 可 以 不 接触 手机 屏幕 ,利用 
手机 的 倾斜 控制 球 板 的 移动 方向 ,但 需要 注意 传感器 控制 球 板 的 敏感 程度 。 在 用 户 操作 
手机 的 过 程 中 ,即使 用 户 水 平 放置 手机 ,也 难以 避免 产生 微小 的 倾斜, 但 此 时 用 户 并 不 希 
望 移动 球 板 。 方 向 传感器 的 属性 roll 表示 手机 的 水 平方 向 的 倾斜 角度 ,这 里 设 定 一 个 门 
限 值 ,只 有 roll 超出 门限 值 时 , 才 可 以 控制 球 板 ,否则 球 板 将 在 原 位 置 上 不 移动 。 设 置 站 
限 值 的 好 处 是 避免 球 板 过 于 敏感 ,以 防 其 不 按照 用 户 的 意图 进行 移动 。Pong 示例 中 这 个 
门限 值 是 4, 在 图 6. 67 所 示 的 逻辑 中 ,条 件 “abs(roll) >4" 就 是 门限 值 的 具体 实现 ,如 果 
roll 的 值 小 于 4, 将 无 法 移动 球 板 。 


图 6.67 方向 传感器 的 OrientationChanged 事件 


在 方向 传感器 的 OrientationChanged 事件 中 ,roll 的 方向 决定 了 球 板 的 移动 方向 ， 
roll 为 正 值 , 球 板 的 X 坐标 值 减 小 , 球 板 向 左 侧 移动 ;roll 为 负 值 , 球 板 的 X 坐标 值 增 加 ， 
球 板 向 右 侧 移动 。 

除了 可 以 使 用 方向 传感器 控制 球 板 以 外 ,还 可 以 在 屏幕 上 滑动 手指 来 控制 球 板 , 这 种 
方式 似乎 更 加 普遍 。 在 图 像 精灵 Paddle 的 Dragged 事件 中 修改 图 像 精灵 Paddle 的 属性 
X 值 ,就 可 以 移动 球 板 。 在 球 板 的 拖 电 过 程 中 ,用 户 触 碰 的 屏幕 点 ,本 意 是 让 球 板 的 中 心 
点 到 达 触 碰 点 。currentX 是 触 碰 点 的 X 坐标 ,在 此 基础 上 减 去 40, 就 可 以 将 球 板 精 灵 的 
中 心 点 移动 到 触 碰 点 上 来 ,如 图 6. 68 所 示 。 


when Dragged 


图 6.68 图 像 精灵 Paddle 的 Dragged 事件 


开始 游戏 要 单 击 Play 按钮 , 重 置 游 戏 要 单 击 Reset 按钮 ,这 两 个 按钮 的 单 击 事件 的 
逻辑 模块 如 图 6. 69 所 示 。 在 ButtonPlay 的 单 击 事件 中 ,首先 调用 自 定义 的 函数 initGame， 
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初始 化 球体 控件 的 基本 参数 ,然后 使 球体 控件 运动 (Enabled 设置 为 true), fE ButtonReset 
的 单 击 事件 中 , 先 让 球体 控件 停止 运动 (Enabled 设置 为 false) ,再 调用 自 定义 的 函数 模块 


initGame。 


uttonPlay ' SESS " Click 


6.69 按钮 单 击 事件 


如 图 6. 70 所 示 , 自 定义 函数 initGame 用 来 初始 化 球体 控件 的 位 置 、 移 动 速度 、 移 动 
方向 ,并 清空 分 数 标签 控件 LabelValue 的 文字 属性 Text, RŽ initGame 将 球体 的 位 置 
设置 到 (20,20) ,球体 的 初始 速度 在 8 一 15 之 间 随 机 选择 ,球体 的 移动 方向 在 0 一 360 之 间 
随机 选择 。 


om integer from 


m integer from 


图 6.70 自 定义 函数 initGame 


如 果 球 体 在 运动 时 碰撞 到 画布 边缘 ,将 产生 球体 的 EdgeReached 事件 。 根 据 游 戏 规 
则 ,球体 碰 到 上 方 、 左 侧 和 右 侧 的 边缘 时 ,球体 会 按照 一 定 角度 进行 反弹 ;如 果 球 体 碰 到 下 
方 的 边缘 ,游戏 会 结束 ,球体 会 停止 在 触 碰 点 上 。 因 此 在 球体 的 EdgeReached 事件 中 , 首 
先 要 检测 参数 edge 的 值 , 当 edge 为 一 1 时 ,表示 小 球 触 碰 到 画布 的 下 方 边缘 , 则 将 球体 的 
Enabled 属性 设置 为 false, 使 小 球 停止 移动 ,并 播放 表示 游戏 结束 的 音效 ; 当 edge 为 其 他 
值 时 ,调用 球体 的 方法 Bounce. 8185 3C edge 进行 反弹 。EdgeReached 事件 的 内 部 模块 
如 图 6.71 所 示 。 


Balll -BEGI 


6.71 球体 的 EdgeReached 事件 
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当 球 体 运 动 碰撞 到 球 板 时 ,球体 应 当 按照 一 定 角度 进行 反弹 ,此 时 将 产生 球体 的 
CollidedWith 事件 。 在 CollidedWith 事件 中 ,参数 other 表示 与 球体 碰撞 的 精灵 ,因为 画 
布 上 只 有 球体 和 球 板 , 因 此 在 每 次 碰撞 事件 中 ,other 一 定 是 球 板 ,但 这 里 的 参数 other 并 
没有 被 使 用 。 在 CollidedWith 事件 中 ,首先 用 360 减 去 球 的 运动 方向 ,表示 球体 碰撞 后 
的 物理 反弹 ,然后 将 记分 的 标签 LabelValue 的 数值 增加 1, 如 图 6. 72 所 示 。 


bi Balll "eo YeT z aaa 


LabelYalue JN ox: MEM 


图 6.72 球体 的 CollidedWith 事件 
Pong 示例 的 全 部 逻辑 模块 如 图 6.73 所 示 。 


图 6.73 Pong 示例 的 全 部 逻辑 模块 
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1. 说 明 图 像 精 灵 和 球体 的 不 同 之 处 和 相同 之 处 。 

2. 实现 “新 画板 ”功能 , 当 手 指 单 击 屏 幕 的 任意 两 个 位 置 时 ,以 这 两 个 位 置 作为 矩形 
的 左上 角 和 右 下 角 绘 制 矩形 图 案 ,可 以 选择 3 种 不 同 的 颜色 ,并 可 随时 清空 画布 内 容 。 

3. 实现 “石头 剪子 布 ”游戏 。 实 现 人 与 手机 的 石头 剪刀 布 游戏 功能 ,每 比较 一 次 , 输 
出 获胜 一 方 的 信息 。 

4. 实现 “打气 球 ” 游 戏 。 在 游戏 开始 后 ,画面 上 随机 出 现 10 个 球 ,这 些 气 球 是 会 任意 
飘动 的 ,用 户 要 在 最 短 的 时 间 内 击破 所 有 气球 ,完成 游戏 后 显示 玩家 所 使 用 的 时 间 。 
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随 着 手机 应 用 的 不 断 扩展 ,手机 在 多 媒体 和 社交 方面 的 需求 逐渐 增多 。AI2 支持 音 
视频 录制 、 音 视频 播放 语音 生成 和 图 片 选择 等 多 媒体 功能 ,也 支持 选取 联系 人 、 选 取 和 号 
码 , 找 号 .发 短信 等 社交 功能 。 通 过 本 章 的 学 习 , 读 者 可 以 熟悉 常见 的 多 媒体 和 社交 应 用 
开发 。 

本 章 学 习 目 标 

。 字 握 媒 体 控件 的 使 用 方法 

。 掌握 社交 控件 的 使 用 方法 
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AI2 支持 的 媒体 控件 共有 9 个 ,包括 录像 机 (Camcorder)、 相 机 (Camera) , 3€ R T. R. 
CImagePicker) .音频 播放 器 (Player) .音效 播放 器 (Sound)、 录音机 (SoundRecorder)、 语 
音 识别 (SpeechRecognizer) ,语音 生成 (TextToSpeech) 和 视频 播放 器 (VideoPlayer) , 如 
图 7.1 所 示 。 

本 节 内 容 所 涉及 的 控件 有 录像 机 、 视 频 播放 器 . 选 图 工具 .音频 播放 器 .录音 机 和 语音 
生成 ,其 余 控 件 将 在 其 他 章节 中 进行 介绍 。 媒 体 控件 的 名 称 和 功能 说 明 如 表 7. 1 所 示 。 


表 7.1 媒体 控件 的 名 称 和 功能 


YW 7 7 
7 , Z 
gy 


E fF 说 B 
录像 机 (Camcorder) 利用 手机 的 摄像 头 实现 视频 的 录制 
相机 (Camera) 用 于 拍摄 相片 
选 图 工具 (ImagePicker) 用 于 在 相册 中 选取 图 片 
音频 播放 器 (Player) 用 于 播放 音频 文件 或 产生 手机 振动 
音效 播放 器 (Sound) 用 于 播放 短 时 间 的 音效 文件 
录音 机 (SoundRecorder) 利用 手机 实现 音频 的 录制 
语音 识别 (SpeechRecognizer) 利用 语音 识别 技术 将 用 户 的 语音 信息 转换 为 文字 
语音 生成 (TextToSpeech) 将 文字 转换 为 语音 
视频 播放 器 (VideoPlayer) 用 于 播放 视频 


a YW 
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7.1.1 录像 机 


录像 机 (Camcorder) 的 功能 是 利用 手机 摄像 头 录制 视频 。 录 像 机 为 非 可 视 化 控件 ， 
没有 可 编辑 的 属性 ,如 图 7.2 所 示 。 

录像 机 控件 简单 易 用 ,只 提供 了 RecoderVideo 方法 ,用 于 启动 视频 录制 过 程 ,如 图 
7.3 所 示 。 


Media 
È Camcorder ? 
iS camera Q 
È= ImagePicker 7 

Player z Non-visible components 
@) Sound ? 
€  SoundRecorder 7 

i Camcorder1 
8 SpeechRecognizer ? 
Wi rextToSpeech 7 图 7.2 非 可 视 化 的 录像 机 控件 
£ VideoPl 
人 si call (TEE .RecordVideo 
图 7.1 媒体 控件 图 7.3 RecoderVideo 方法 


RecoderVideo 方法 启动 手机 摄像 头 的 录制 功能 后 ,一般 手机 的 录制 过 程 会 被 手机 内 
置 的 “录像 (照相 软件” 所 接管 ,笔者 的 手机 “录像 (照相 ) 软 件 " 如 图 7.4 所 示 。 在 录制 成 
功 后 ,可 以 选择 “放弃 ”或 “存储 ”, 如 果 选 择 “ 放 弃 ”, 则 这 次 录制 过 程 将 被 取消 ;如 果 选 择 
“存储 ”, 存 储 路 径 等 信息 会 在 AfterRecording 事件 中 被 获取 到 。 


图 7.4 手机 内 置 的 “录像 (照相 ) 软 件 ” 
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AfterRecording 事件 在 录像 过 程 结束 时 产生 ,主要 功能 是 提供 录像 视频 的 存储 路 径 ， 
when .AfterRecording 


信息 保存 在 clip 参数 中 ,如 图 7. 5 所 示 。 
7.1.2 视频 播放 器 


视频 播放 器 (VideoPlayer) 主要 用 于 播 
放 视 频 文件 ,提供 基础 的 视频 播放 控制 功 
能 ,包括 播放 .暂停 和 调整 播放 位 置 等 。 视 人 
频 播放 器 在 界面 编辑 器 中 显示 为 矩形 ,如 图 7.6 所 示 。 

视频 播放 器 控件 最 重要 的 属性 是 Source, 用 来 设 定 所 播放 的 视频 文件 。 视 频 播 放 器 
支持 主流 的 媒体 文件 类 型 ,包括 Windows Media Video(. wmv) .3GPP(. 3gp), 和 MPEG -4 
(.mp4)。 但 要 注意 的 是 ,AI2 支持 的 视频 资源 最 大 为 1MB, 因 此 视频 文件 应 通过 截取 片 
段 或 者 压缩 等 方式 尽量 缩小 体积 。 

视频 播放 器 仅 支持 Completed (播放 完成 ) 事 件 ,在 播放 到 视频 文件 结尾 时 产生 ， 
Completed 事件 如 图 7.7 所 示 。 


VideoPlayerl + Beo; aa! 


图 7.6 界面 编辑 器 中 的 视频 播放 器 控件 图 7.7 Completed 事件 


视频 播放 器 支持 Start, Pause, SeekTo 和 GetDuration 方法 ,调用 这 些 方法 可 以 控制 
视频 播放 过 程 。 视 频 播 放 器 所 支持 的 方法 如 表 7.2 所 示 。 


表 7.2 视频 播放 器 的 方法 


方 法 说 — 明 
Start 开始 播放 视频 文件 
Pause 暂停 播放 当前 视频 
SeekTo 调整 播放 位 置 到 所 指定 时 间 处 (单位 毫秒 ) 
GetDuration 返回 视频 的 持续 时 间 ( 单 位 毫秒 ) 


在 视频 播放 器 上 单 击 播放 画面 ,可 以 弹出 “视频 控制 界面 ", 使 用 内 置 的 “视频 控制 界 
面 ?可 以 在 一 定 程度 上 减轻 开发 工作 ,如 图 7.8 所 示 。 

下 面 将 在 RecordPlayer 示例 中 展示 如 何 使 用 录像 机 和 视频 播放 器 ,制作 一 个 可 以 使 
用 手机 摄像 头 进行 录像 ,并 可 以 直接 播放 录像 内 容 的 应 用 程序 RecordPlayer 示例 ,运行 
界面 如 图 7.9 所 示 ,界面 上 的 元 素 简单 明了 ,摄像 ”“ 播 放 ” 和 ”停止 ?3 个 按钮 实现 了 应 
用 程序 的 主要 功能 ,反馈 信息 在 标签 “显示 播放 器 信息 ”中 显示 。 
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RecordPlayer 


摄像 播放 停止 
显示 播放 器 信息 
图 7.8 视频 控制 界面 图 7.9 RecordPlayer 示例 运行 界面 


在 界面 编辑 器 中 很 容易 找到 非 可 视 化 的 摄像 机 控件 Camcorderl 以 及 可 见 的 视频 播 
放 器 控件 VideoPlayerl ,如 图 7. 10 所 示 


Viewer Components 
Display hidden components in Viewer © 门 sseem 
日 ES uorizontalArrangementt 
RecordPlayer A|LabelTitle. 
摄像 播放 器 ESviaeoplayert 
Ə PB orizontalArrangement2 


li puttonRecord 
国 Buttonplay 

| 国 Buttonstop 
AlLabellnfo 

种 camcorden 


播放 fu 


Rename Delte 
Non-visible components 
d Media 
Camcorder1 
Upload File 


图 7. 10 RecordPlayer 示例 界面 设计 图 
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逻辑 部 分 ,在 “摄像 ”(ButtonRecord) 按 钮 的 单 击 事件 中 调用 摄像 机 Camcorder 的 
RecordVideo 方法 ,实现 手机 的 摄像 功能 ,如 图 7. 11 所 示 。 


when -Click 


do call . RecordVideo 
一 


图 7.11 Click 事件 


在 摄像 完毕 (AfterRecoding) 后 ,将 视频 文件 保存 位 置信 息 传递 给 视频 播放 器 
VideoPlayerl 的 属性 Source。 此 时 ,视频 播放 器 VideoPlayerl 已 经 获得 要 播放 视频 的 路 
径 信息 ,只 要 调用 视频 播放 器 的 Start 方法 ,就 可 以 播放 这 个 视频 文件 ,如 图 7. 12 所 示 。 


when -AfterRecording 


do set E [NIE clip ， 


图 7.12  AfterRecording 事件 


其 次 ,还 要 响应 播放 按钮 (ButtonPlay) 和 停止 按钮 (ButtonStop) 的 单 击 事件 。 
播放 按钮 (ButtonPlay) 要 调用 视频 播放 器 VideoPlayerl 的 Start 方法 播放 视频 ,如 
图 7.13 所 示 , 并 将 视频 的 长 度 信息 (GetDuration) 显示 在 标签 LabelInfo 中 。 


when .Click 


do call 


.GetDuration 


图 7.13 ButtonPlay 的 单 击 事件 


停止 按钮 (ButtonStop) 会 调用 视频 播放 器 VideoPlayerl 的 Stop 方法 暂停 视频 播放 ， 
并 在 标签 LabelInfo 上 显示 提示 信息 “暂停 播放 ”, 如 图 7. 14 所 示 。 再 次 单 击 播放 按钮 ， 
视频 将 在 上 次 暂停 的 地 方 继续 播放 。 


LIGUE ButtonStop "MAEI 


do ll 


图 7.14 ButtonStop 的 单 击 事件 


最 后 就 是 在 视频 播放 器 完成 播放 后 ,标签 Labellnfo 中 显示 “完成 播放 ”信息 。 这 在 
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所 示 。 


Wa VideoPlayerl "> 天 wd 


do set 
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7.15 视频 播放 器 的 Completed 事件 


RecordPlayer 示例 的 全 部 逻辑 模块 如 图 7. 16 所 示 。 


shen -Click 
x "m .AfterRecording 


de call 


when Click 
do call Pause 


when EIT . Conpleted 


do 


sl, BurtonPlay * MAET 


do call 


zm 


Hi 7.16  RecordPlayer 示例 的 全 部 逻辑 模块 


7.1.3 选 图 工具 


ImagePicker( 选 图 工具 ) 控 件 能 实现 从 手机 的 相册 中 选取 图 片 的 功能 。 选 图 工具 在 
界面 上 的 显示 外 观 类 似 于 按钮 ,如 图 7. 17 所 示 , 当 用 户 单 
击 选 图 工具 时 ,就 会 调用 手机 内 置 的 相册 软件 浏览 手机 内 LTest for ImagePickerl | 
部 保存 的 图 片 ,进而 从 中 选择 需要 的 图 片 。 图 7.17 选 图 工具 

选 图 工具 的 Image 属性 用 来 表示 选择 的 图 片 ， 

Selection 属性 则 以 字符 串 的 形式 保存 图 片 文件 的 路 径 信息 。 

选 图 工具 支持 4 种 事件 , 即 选 图 后 (AfterPicking) 事 件 、 选 图 前 (BeforePicking) 事 件 、 

获取 焦点 (GotFocus) 事 件 和 失去 焦点 (GotFocus) 事 件 ,如 图 7. 18 所 示 。 


when eben .AfterPicking 


when GotFocus 


图 7.18 选 图 工具 支持 的 4 种 事件 
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选 图 工具 只 支持 Open 方法 ,用 来 打开 手机 内 置 的 相册 软件 ,如 图 7. 19 所 示 。 
7.1.4 音频 播放 器 


音频 播放 器 (Player) 用 来 播放 音频 文件 ,一 般 用 于 播放 时 间 较 长 的 音频 文件 ,如 音 
乐 .录音 等 。 如 果 音 频 时 间 较 短 , 如 铃声 .提示 音 , 建 设 使 用 音效 播放 器 (Sound) 控 件 , 因 
为 音效 播放 器 消耗 的 资源 较 少 。 

音频 播放 器 除了 具有 音频 播放 功能 外 ,还 可 以 让 手机 产生 振动 。 音 频 播 放 器 属于 非 
可 视 化 控件 ,在 界面 编辑 器 中 的 音频 播放 器 如 图 7. 20 所 示 。 


Non-visible components 


> 
Ce Player 


图 7.19 选 图 工具 的 Open 方法 图 7.20 音频 播放 器 


音频 播放 器 支持 4 个 属性 ,分 别 为 TSPlaying、Loop Source #l Volume, IsPlaying X 
示 是 否 正在 播放 ;Loop 表示 是 否 循环 播放 ;Source 属性 用 来 定义 音频 文件 源 ,可 以 是 上 
传 的 音频 文件 ,也 可 以 是 网 络 中 的 音频 文件 ;Volume 表示 播放 音量 ,是 0 一 100 的 整数 ， 
数值 越 大 ,音量 越 大 。 音 频 播 放 器 支持 常见 的 mp3、wav、mid 和 3gp 等 音频 格式 。 

音频 播放 器 唯一 支持 的 事件 是 Completed, 如 图 7. 21 所 示 。Completed 事件 在 音频 
播放 完成 后 产生 ,通常 用 于 执行 播放 完毕 后 的 下 一 步 动作 。 

音频 播放 器 支持 Start, Pause, Stop 和 Vibrate 4 种 方法 ,用 于 开始 、 暂 停 或 停止 音频 
播放 以 及 控制 手机 振动 ,说 明 如 表 7. 3 所 示 。 


表 7.3 音频 播放 器 的 方法 


方法 描 述 
Pause 暂停 当前 播放 
when . Completed Start 开始 播放 
do Stop 停止 播放 
Vibrate 手机 振动 


图 7.21 Completed 事件 


Vibrate 方法 会 让 手机 产生 一 段 时 间 的 振动 ,振动 时 间 由 参数 millisenconds 控制 , 单 
位 是 毫秒 ,如 图 7. 22 所 示 。 

下 面 将 通过 MusicGallery 示例 ,介绍 如 何 使 用 选 图 工具 和 音乐 播放 器 设计 应 用 程 
序 , 示 例 运行 界面 如 图 7. 23 所 示 。MnusicGallery 示例 实现 的 功能 类 似 于 音乐 相册 ,在 播 
放 背 景 音 乐 的 同时 ,循环 显示 用 户 选择 的 图 片 。 

用 户 单 击 “ 选 取 图 片 ”按钮 可 以 从 手机 图 片 库 中 选取 图 片 , 可 以 选取 一 张 ,也 可 以 选取 
多 张 。 在 选择 图 片 完 成 后 ,就 可 以 单 击 “ 启 动 相册 ”按钮 ,开始 真正 的 “音乐 相册 ”之 旅 。 在 
用 户 单 击 “ 停 止 相册 ”按钮 前 ,将 持续 播放 音乐 和 循环 显示 图 片 。 最 下 面 的 滑动 条 可 以 控 
制图 片 的 切换 速度 。 
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音乐 画册 


\ I 
先 选取 照片 ， 再 启动 相册 
call .Vibrate 选取 图 片 cuum — mima 


. . 图 片 切换 速度 ( 秒 / 张 ) : 5 
milliseconds O 


图 7.22 Vibrate 方法 图 7.23 MusicGallery 示例 的 运行 界面 


在 界面 设计 过 程 中 ,要 注意 将 “启动 相册 ”和 “停止 相册 ”按钮 的 Enabled 项 设 为 
false, 只 允许 用 户 在 至 少 选 择 一 张 图 片 后 才 可 以 启动 相册 。 
如 图 7. 24 所 示 为 示例 界面 设计 。 
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先 选取 照片 ， 再 启动 相册 
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图 7.24 MusicGallery 示例 的 界面 设计 图 
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将 时 钟 Clockl 的 Enabled 项 设 为 false, 让 时 钟 在 用 户 单 击 * 启 动 相册 ”按钮 以 后 才 启 
动 , 因 为 时 钟 的 主要 作用 是 周期 性 切换 图 片 。Clockl 的 时 间 间 隔 (TimerInterval) 设置 为 
5000 毫秒 (5 秒 ) ,TimeAlwaysFires 设置 为 true, 

为 了 保持 时 钟 Clockl 的 周期 设置 与 显示 一 致 ,要 将 标签 LabelSpeedValue 的 Text 
属性 设置 为 5, 表示 “图 片 切换 的 速度 为 5 秒 / 张 "。 滑 动 条 的 ThumbPosition 属性 也 设置 
为 5,MinValue 为 1,MaxValue 为 20。 

音频 播放 器 Playerl 的 Source 属性 设置 为 已 经 上 传 的 MIDI 音频 文件 (music. mid), 
读者 也 可 以 选择 自己 喜欢 的 音频 ,但 需要 控制 文件 的 大 小 ,避免 资源 文件 的 上 传 时 间 过 
长 。 音 频 播放 器 的 Loop 属性 设置 为 true, 因 为 这 里 需要 无 限 循 环 播放 背景 音乐 。 

在 逻辑 编辑 器 中 ,首先 定义 两 个 全 局 变量 picList 和 picIndex, 如 图 7. 25 所 示 。 
picList 是 个 图 片 列表 ,用 于 保存 用 户 选择 的 图 片 ;picIndex 表示 当前 显示 的 图 片 在 列表 
中 的 索引 位 置 。 


initialize global to create empty list 


initialize global 


图 7.25 定义 全 局 变量 


用 户 操 作 的 第 一 步 是 选择 图 片 。 如 图 7. 26 所 示 , 在 选 图 工具 ImagePicker1 的 
AfterPicking 事件 中 ,将 选择 的 图 片 添 加 到 全 局 变量 picList 中 ,并 在 标签 LabelInfo rp W. 
示 用 户 已 经 添加 的 图 片 数 量 。 用 户 选择 图 片 后 ,就 可 以 通过 修改 “启动 相册 ”按钮 的 
Enable 属性 为 true, 允许 单 击 该 按钮 启动 音乐 相册 。ImagePickerl 的 AfterPicking 事件 
的 逻辑 功能 如 图 7. 26 所 示 。 


bi ImagePickerl * BETRCITZTS SU 


do add items to list list 


图 7.26 AfterPicking 事件 


用 户 操作 的 第 二 步 是 通过 单 击 “启动 相册 ”按钮 启动 音频 播放 器 Playerl 音频 播放 功 
能 ,这 里 通过 调用 Playerl 的 Start 方法 实现 ;并 将 时 钟 Clockl 的 TimerEnabled 属性 设 
置 为 true, 用 来 启动 时 钟 切换 图 片 ;最 好 调用 ButtonPlay 和 ButtonStop 按钮 的 Enabled 
属性 控制 两 个 按钮 是 否 可 以 单 击 。ButtonPlay 按钮 的 Click 事件 的 逻辑 如 图 7. 27 所 示 。 

用 户 单 击 “ 启 动 相册 ”按钮 ,时 钟 被 启动 ,只 有 在 一 个 周期 完成 后 才能 够 切换 图 片 到 用 
户 选 择 的 图 片上 。 为 了 能 够 立即 切换 图 片 ,需要 调用 一 次 ChangePic 函数 实现 图 片 切换 。 

如 图 7. 28 所 示 ,ChangePic 函数 通过 全 局 变量 picIndex 获取 列表 picList 中 的 图 片 
位 置信 息 ,将 其 赋值 给 Imagel 的 Picture 属性 ,实现 显示 图 片 内 容 的 修改 ;更 新 LabelInfo 
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when -Click 


do | call 


7.27 ButtonPlay 按钮 的 Click 事件 


中 显示 的 “当前 显示 图 片 信息 ”的 内 容 ; 然 后 将 全 局 变量 picIndex 的 值 增加 1 ,并 检测 这 个 
索引 值 是 否 超出 列表 的 实际 项 数 , 如 果 超 出 , 则 将 其 赋值 为 1 ,实现 列表 的 循环 访问 。 


Elobal picList v | 
[clocbal picIndex + ] 


BICORNIS global picList + ] 


图 7.28 ChangePic 函数 


时 钟 Clockl 被 启动 后 ,因为 TimeAlwaysFires 属性 被 设置 为 true, 所 以 时 钟 Clockl 
启动 后 会 持续 产生 Timer 事件 。 在 Timer 事件 
中 ,只 是 调用 函数 ChangePie 实现 图 片 的 循环 切 [Ru . Timer 


换 ,如 图 7. 29 所 示 。 E call 
通过 滑动 条 的 PositionChanged 滑动 事件 ,可 =< 


以 立即 修改 时 钟 Clockl 的 TimerInterval 属性 ， 
无 论 时 钟 是 否 被 启动 ,都 可 以 影响 时 钟 下 一 次 产 
生 Timer 触发 事件 的 周期 。 滑 动 条 Sliderl 的 PositionChanged 事件 如 图 7. 30 IZR 


7.29 时 钟 Clockl 的 Timer 事件 


uN Slider! - EDEN ns 


do set š o [3d thumbPosition * 


7.30 滑动 条 的 PositionChanged 事件 


用 户 操作 的 第 三 步 是 通过 单 击 * 停 止 相册 ?按钮 ,停止 音乐 播放 ,停止 图 片 切换 和 暂停 
时 钟 Clockl ,逻辑 功能 如 图 7. 31 所 示 。 
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LUE ButtonStop ~ MAETI 


do | call 


HH 7.31  ButtonStop 按钮 的 Click 事件 | 


停止 音乐 播放 可 以 调用 Playerl 的 Pause 方法 来 实现 。 这 里 没有 使 用 Stop 方法 , 因 
为 使 用 Stop 方法 后 会 引发 异常 ,而 且 音乐 要 在 用 户 再 次 单 击 “ 启 动 相册 ”时 继续 播放 ,所 
以 使 用 Pause 方法 更 加 适合 ;同时 调用 ButtonPlay 和 ButtonStop 按钮 的 Enabled 属性 ， 
控制 两 个 按钮 是 否 可 以 单 击 ;最 后 修改 时 钟 Clockl 的 TimerEnabled 属性 ,将 其 设置 为 
false, 停 止 切换 图 片 。 

MusicGallery 示例 的 全 部 逻辑 模块 如 图 7. 32 所 示 。 


ET 


图 7.32  MusicGallery 示例 的 全 部 逻辑 模块 


7.1.5 语音 生成 


语音 生成 (TextToSpeech) 控 件 可 以 自动 将 文本 转换 为 语音 ,是 一 个 非 可 视 化 控件 ， 
如 图 7.33 所 示 。 语 音 生成 需要 手机 内 置 的 TTS 扩展 服 Non-visible components 
务 应 用 (TTS Extended Service app) 的 支持 ,如 果 手 机 没 = 
有 预 装 该 应 用 ,可 以 到 网 站 进行 下 载 ,网 址 为 http: // 


code. google. com/p/eyes-free/downloads/ list 


TextToSpeech1 
7.33 语音 生成 
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语音 生成 支持 的 事件 有 BeforeSpeaking( 语 音 生 成 前 事件 ) 和 AfterSpeaking( 语 
成 后 事件 ) ,如 图 7. 34 所 示 。 


mt 
He 


DINE TextToSpeechl EOY bi TextToSpeechl -BESALS 


do 


图 7.34 语音 生成 支持 的 事件 


BeforeSpeaking 事件 在 文本 转换 为 语音 后 ,但 语音 还 没有 被 播放 前 发 生 ; 
AfterSpeaking 事件 在 语音 被 播放 后 发 生 , 参数 
result 是 个 布尔 值 ,表示 是 否 语音 生成 成 功 。 

语音 生成 的 Speak 方法 ,在 槽 message 上 提 
供需 要 转换 为 语音 的 文本 内 容 , 用 户 调用 该 方法 图 7.35 语音 生成 的 Speak 方法 
将 文本 转换 为 语音 ,如 图 7. 35 所 示 。 

语音 生成 支持 的 属性 有 Country CF] ZO , Language (语言 ) 和 Result (结果)。Result 
用 来 表示 语音 是 否 被 正确 生成 过 。Country 和 Language 用 来 表示 生成 的 语音 类 型 ( 国 
家 十 语言 ), 用 3 个 字母 表示 。 例 如 要 生成 英 式 英语 , 则 可 以 设置 Language 为 eng, DERE 
Country 为 GBR; 要 生成 美式 英语 , 则 可 以 设置 Language 为 eng, 设 置 Country 为 USA. 
Country( 国 家 ) 和 Language( 语 言 ) 的 具体 设置 说 明 如 表 7.4 所 示 。 


37.4 Country 和 Language 的 设置 说 明 


Language H A) Country( 国 家 ) 说 明 
ces CZE 捷克 语 (Czech) 
spa ESP USA 西班牙 语 (Spanish) 
AUT DEU 

deu BEL LIE 德语 (German) 
CHE LUX 
BEL FRA 

fra CAN LUX 法 语 (French) 
CHE 

nld BEL NLD 荷兰 语 (Dutch) 

ita CHE ITA 意大利 语 (Italian) 

pol POL 波兰 语 (Polish) 
AUS NAM 

eng BEL NZL 英语 (English) 
BWA PHL 
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续 表 
Language( 语 言 ) Country( 国 家 ) 说 明 
BLZ PAK 
CAN SGP 
GBR TTO 
HKG USA 
eng ni m 3& iB (English) 
IND ZAF 
JAM ZWE 
MLT MHL 
7.1.6 录音 机 


录音 机 (SoundRecorder) ,顾名思义 就 是 用 来 录音 的 控件 ,是 一 个 非 可 视 化 控件 ,在 界 
面 编辑 器 中 的 录音 机 如 图 7. 36 所 示 。 


Non-visible components 
录音 机 没有 可 支持 属性 ,支持 的 事件 有 


StartedRecording OT A R fli] FF) , StoppedRecording (f£ e 
REN SoundRecorder1 
止 录制 事件 ) 和 AfterSoundRecorded( 完 成 录制 事件 ) ,如 
图 7.36 录音 机 


图 7. 37 所 示 。 


[2E SoundRecorderl * PPU 
when .AfterSoundRecorded 


SoundRecorderL + PAQ S ara 


图 7.37 录音 机 支持 的 事件 


StartedRecording 事件 表明 录音 机 已 经 开始 录制 ,可 以 停止 录制 ;StoppedRecording 
事件 表明 录音 机 已 经 停止 录制 ,可 以 开始 录制 ;AfterSoundRecorded 事件 表明 有 新 生产 
的 音频 文件 ,参数 sound 是 文件 的 位 置信 息 。 

音 机 支持 Start 和 Stop 方法 ,用 于 开始 录音 和 停止 录音 ,如 图 7. 38 所 示 。 


图 7.38 录音 机 支持 的 方法 


下 面 将 通过 VoiceRecorder 示例 介绍 如 何 使 用 录音 机 (SoundRecorder) 和 语音 生成 
(TextToSpeech) 开 发 应 用 程序 。VoiceRecorder 示例 实现 了 一 个 具有 语音 功能 的 录音 
机 ,用 户 可 以 录制 声音 ,录制 好 的 声音 可 以 显示 存储 位 置信 息 ;用户 可 以 播放 最 后 一 次 录 
制 好 的 声音 ;在 用 户 所 有 操作 过 程 中 , 单 击 不 同 按钮 会 产生 不 同 的 辅助 操作 语音 。 
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VoiceRecorder 示例 的 运行 界面 如 图 7. 39 所 示 。 


VoiceRecorder 


语音 录音 机 


开始 录音 。 “播放 录音 


storage/emulated/0/My Documents/Recordings/ 
pp_inventor_1396876755760.3gp 


7.39 VoiceRecorder 示例 的 运行 界面 


在 界面 设计 过 程 中 ,要 注意 将 “播放 录音 ”按钮 的 Enabled 属性 设 为 false, 只 允许 用 户 在 
录音 后 才 可 以 播放 录音 。 标 签 Labellnfo 在 初始 化 时 显示 “录音 存储 信息 ”, 在 每 次 录音 结束 
后 ,用 来 显示 录音 文件 的 存储 位 置 。 语 音 生 成 TextToSpeech 1 的 Country 和 Language 属性 
本 示例 中 没有 进行 任何 设置 。VoiceRecorder 示例 的 界面 设计 如 图 7. 40 所 示 。 


Viewer Components 


E isplay hidden components in Viewer 9 seem 


[A] Laberitie 


国 ,maoe 
语音 录音 机 E Horizontalarangement2 
日 国 hoizortalarangement 
国 eutonnecorder 
lil puttonPlsy 
|AJ Lzbelinfo. 
® scundíecorderi 
W TextTospeecm 
V» Playert 


录音 存储 信 息 


Rename Delete 


Non-visible components 


° ad > Media 


SoundRecorder! TextToSpeechl Playeri 
sound jpg 


Upload File .. 


图 7. 40  VoiceRecorder 示例 的 界面 设计 图 
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在 逻辑 编辑 器 中 ,首先 设计 ButtonRecorder 按钮 的 Click 事件 ,如 图 7. 41 所 示 。 这 
个 按钮 是 “开始 录音 ”按钮 ,用 户 单 击 后 ,按钮 上 的 文字 需要 自动 变 为 “停止 录音 ”。 在 每 次 
用 户 操 作 时 ,都 是 调用 TextToSpeechl 的 Speak 方法 将 不 同 的 文本 转换 为 辅助 操作 的 语 
音 。 需 要 注意 的 是 ,一 定 要 在 “开始 录音 ”操作 (SoundRecorder. Start) 前 播放 辅助 操作 的 
语音 (TextToSpeechl. Speak) ,否则 会 将 辅助 操作 语音 录 下 来 。“ 停 止 录音 ”操作 也 是 同 
样 的 道理 ,要 先 停 止 录音 ,然后 再 播放 辅助 操作 语音 ,如 图 7. 41 所 示 。 


when Click 


图 7.41 ButtonRecorder 按钮 的 单 击 事件 


用 户 录 音 完毕 后 ,需要 将 录音 文件 的 位 置 记录 下 来 ,播放 该 录音 的 时 候 使 用 。 这 样 定 
义 一 个 全 局 变量 soundPath ,在 SoundRecorderl 的 AfterSoundRecorded 事件 中 ,将 录音 
文件 的 位 置 参数 sound 赋值 给 全 局 变量 soundPath, 并 在 标签 LabelInfo 中 显示 录音 文件 
的 位 置信 息 , 如 图 7. 42 Brom 


initialize 


Misti SoundRecorder1 PESA A a 


图 7.42 AfterSoundRecorded 事件 


全 局 变量 soundPath 中 保存 了 录音 文件 的 位 置信 息 后 ,就 可 以 在 ButtonPlay 按钮 的 
Click 事件 中 播放 录音 了 ,如 图 7.43 所 示 。ButtonPlay 按钮 的 文字 切换 和 播放 辅助 操作 
语音 功能 与 ButtonRecorder 按钮 的 Click 事件 非常 相似 ,这 里 不 再 重复 介绍 。 播 放声 音 
文件 使 用 的 是 Playerl 控件 , 先 设置 Source 属性 ,将 全 局 变量 soundPath 赋值 给 Source 
属性 ,然后 调用 Playerl 的 Start 方法 ,就 可 以 实现 录音 的 播放 ; 若 要 停止 录音 播放 ,只 要 
调用 Playerl 的 Stop 方法 即 可 。 

虽然 可 以 通过 单 击 “停止 播放 ”按钮 强行 停止 录音 的 播放 ,但 如 果 录 音 自动 播放 完毕 
后 ,“ 停 止 播放 ”按钮 的 文字 (Text) 是 不 会 自动 变 为 “开始 播放 ”的 。 这 样 就 需要 在 录音 播 
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when EXEIETEYE Click 


7.43 ButtonPlay 按钮 的 Click 事件 


放 完 毕 后 (Playerl 的 Completed 事件 ), 使 用 语音 提示 用 户 “ 播 放 完 毕 ", 并 且 将 
ButtonPlay 按钮 的 文字 更 改 为 “开始 播放 ”, 如 图 7. 44 Bros. 


LUE Playeri * Yo taal 


7.44 Playerl 的 Completed 事件 


VoiceRecorder 示例 的 全 部 逻辑 模块 如 图 7. 45 所 示 。 


图 7.45  VoiceRecorder 示例 的 全 部 逻辑 模块 
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72 MEH 


时 至 今日 ,手机 的 用 途 早 已 不 仅仅 局 限于 单纯 打 电话 ,其 社交 功能 也 成 为 了 基本 功能 
之 一 。AI2 支持 6 个 社交 控件 ,包括 选取 联系 人 
(ContactPicker) .邮件 地 址 工具 (EmailPicker) 、 拨 Social 
号 (PhoneCall) .选取 号 码 (PhoneNumberPicker)、 B) ContactPicker 
短信 息 (Texting) M Hè fF (Twitter), 如 图 7. 46 


E EmailPicker 
所 示 。 
需要 注意 的 是 ,在 PhoneCell 和 Texting 控件 PhoneCall 
的 使 用 过 程 中 ,可 能 会 产生 一 定 的 费用 。 而 且 社交 PhoneNumberPicker 
控件 会 从 手机 的 联系 人 中 获得 真实 信息 ,因此 在 软 Texting 
件 开发 和 调试 过 程 中 ,不 要 干扰 到 他 人 的 正常 
生活 。 Twitter 
表 7.5 中 给 出 了 社交 控件 的 具体 功能 说 明 。 
因为 国家 防火 墙 对 国内 出 境 数据 的 选择 性 过 滤 等 图 7.46 社交 控件 
原因 ,Twitter 控件 暂时 无 法 使 用 ,因此 本 书 暂 不 介 
绍 Twitter 控件 的 使 用 方法 。 
表 7.5 社交 控件 功能 
E 件 说 — H 
选取 联系 人 (ContactPicker) 打开 手机 的 电话 夭 , 选 取 联系 人 信息 
邮件 地 址 工具 (EmailPicker) 辅助 用 户 完成 电子 邮件 地 址 输入 
拨号 (PhoneCall) 拨打 电话 
选取 号 码 (PhoneNumberPicker) 打开 手机 的 电话 德 , 选 取 联系 人 电话 号 码 
短信 息 (Texting) 发 送 短信 息 
推 特 (Twitter) 可 以 与 Twitter 服务 器 通信 


7.2.1 选取 联系 人 


选取 联系 人 (ContactPicker) 控 件 的 功能 是 从 手机 的 通讯 录 中 获得 联系 人 信息 ,这 些 
信息 包括 联系 人 的 姓名 、 头 像 和 电子 邮件 地 址 。ContactPicker 控件 在 界面 上 的 显示 效果 
与 按钮 相同 ,如 图 7.47 所 示 。 

当 调 用 ContactPicker 的 Open 方法 后 ,手机 的 通讯 录 会 被 打开 。Open 方法 如 图 7. 48 
所 示 。 
在 通讯 录 被 打 后 ,联系 人 会 以 列表 的 形式 呈现 ,如 图 7. 49 所 示 。 在 选择 目标 联系 人 
后 ,通讯 录 会 自动 关闭 ,此 时 联系 人 的 信息 将 被 保存 在 ContactPicker 中 。 
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《四 选择 联系 人 
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w 
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图 7.48  ContactPicker 的 Open 方法 图 7.49 联系 人 列表 


ContactPicker 的 外 观 属 性 ,如 字体 .尺寸 .是 否 可 见 等 和 按钮 相同 ,其 所 支持 的 专 有 
属性 如 表 7.6 所 示 。 


表 7.6 ContactPicker 属性 及 说 明 


属性 说 明 属性 说 明 
ContactName 联系 人 姓名 Picture 联系 人 头像 
EmailAddress 联系 人 邮箱 


ContactPicker 支持 4 个 事件 .分别 为 AfterPicking( 选 择 后 事件 )、BeforePicking( 选 


择 前 事件 ) .GotFocus( 获 取 焦 点 事件 ) 和 LostFocus( 失 去 焦点 事件 ) ,如 表 7.7 所 示 。 
表 7.7 ContactPicker 事件 及 说 明 
事 0d dos 
AfterPicking 在 用 户 选 择 目标 联系 人 后 产生 
BeforePicking 在 用 户 打 开通 讯 录 ,但 是 尚未 选择 目标 联系 人 时 产生 
GotFocus 获取 焦点 时 产生 
LostFocus 失去 焦点 时 产生 


将 ContactPicker 和 标签 .文本 框 等 控件 结合 ,就 可 以 组 成 简单 的 电话 短 应 用 程序 。 
除 此 之 外 ,还 可 以 利用 ContactPicker 的 返回 结果 ,为 其 他 应 用 提供 信息 ,如 语音 留言 、 自 
动 拨号 和 定义 联系 人 信息 等 。 
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7.2.2 选取 号 码 


选取 号 码 (PhoneNumberPicker) 控 件 可 以 获取 手机 通讯 录 中 的 联系 人 信息 ,这 些 信 
息 包括 联系 人 的 姓名 、 头 像 、 电 子 邮件 地 址 和 电话 号 码 , 如 
图 7.50 所 示 。 Text for PhoneNumberPicker1 | 
PhoneNumberPicker 控件 的 显示 效果 、 属 性 .事件 和 工 图 7.50 选取 号 码 控件 
作 方 式 均 与 选取 联系 人 控件 相同 ,区 别 在 于 选取 号 码 控件 
可 以 多 获取 一 项 数据 , 即 电话 号 码 。 
二 者 在 通讯 录 中 选择 联系 人 的 界面 也 稍 有 区 别 ,ContactPicker 显示 的 是 联系 人 的 姓 
名 列表 ,而 PhoneNumberPicker 使 用 的 则 是 “姓名 十 电话 ”列表 ,如 图 7.51 所 示 
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图 7.51 选取 信息 的 区 别 


7.2.3 邮件 地 址 工具 


邮件 地 址 工具 (EmailPicker) 控 件 在 用 户 输 入 联系 人 的 电子 邮件 地 址 时 ,提供 自动 完 
成 邮件 地 址 输入 的 功能 。 通 常 ,邮件 地 址 工具 与 按钮 控件 同时 使 用 ,用 户 单 击 按钮 控件 
后 ,自动 完成 邮件 地 址 的 输入 和 显示 。 

邮件 地 址 工具 在 界面 上 的 显示 效果 类 似 于 文本 框 , 没 有 控件 方法 , 仅 有 获取 焦点 事件 
(GetFocus) 和 失去 焦点 事件 (LostFocus)。 除 Text 和 Hint 属性 之 外 ,其 余 用 于 设置 外 观 
效果 等 的 属性 和 文本 框 控 件 类 似 , 这 里 不 再 重复 介绍 。 邮 件 地 址 工具 在 界面 上 的 显示 效 
果 如 图 7. 52 所 示 。 


7.2.4 拨号 


拨号 控件 (PhoneCell) 控 件 是 一 个 非 可 视 化 控件 ,用 于 向 指定 的 电话 号 码 拨打 电话 ， 
如 图 7. 53 所 示 。 
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Non-visible components 


图 


PhoneCall1 
图 7.52 邮件 地 址 工具 控件 图 7.53 拨号 控件 


Hint for EmailPicker1 


拨号 控件 只 有 一 个 属性 PhoneNumber 和 一 个 方法 MakePhoneCall, 如 图 7. 54 所 示 。 


j .MakePhoneCall 


B] 7.54 MakePhoneCall 方法 


PhoneNumber 属性 中 保存 着 目标 电话 号 码 , 此 属性 可 以 在 界面 编辑 器 中 修改 ,也 可 
以 在 模块 编辑 器 中 修改 。 在 设 定 PhoneNumber 属性 后 ,调用 MakePhoneCall 方法 可 以 
调 出 手机 拨号 界面 自动 拨打 PhoneNumber 属性 中 的 电话 号 码 , 如 图 7. 55 所 了 示 。 但 如 果 
PhoneNumber 属性 中 没有 设 定 任何 电话 号 码 ,MakePhoneCall 方法 将 不 会 被 执行 。 

拨号 控件 通常 与 选取 号 码 控件 结合 使 用 。 其 通常 的 使 用 方法 是 将 选取 号 码 控件 中 获 
得 的 电话 号 码 赋 值 给 拨号 控件 的 PhoneNumber 属性 ,然后 再 调用 拨号 控件 的 
MakePhoneCall 方法 拨打 电话 。 
7.2.5 短信 息 

短信 息 (Texting) 控 件 主要 用 来 发 送 和 接收 短信 息 。 短 信息 控件 也 是 非 可 视 化 控件 ， 
在 界面 编辑 器 中 的 效果 如 图 7. 56 所 示 。 
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图 7.55 手机 拨号 界面 图 7.56 短信 息 控件 
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短信 息 控件 的 主要 属性 如 表 7. 8 所 示 。 其 中 ,GoogleVoiceEnabled 属性 表示 是 否 启 
动 GoogleVoice 功能 。 如 果 用 户 有 GoogleVoice 账号 ,短信 息 将 利用 WiFi 网 络 通过 
GoogleVoice 进行 发 送 。PhoneNumber 属性 表示 发 送 短信 的 目标 电话 号 码 ,形式 是 一 组 
数字 ,如 18600001111 ,但 不 能 包含 标点 符号 和 空格 。 


表 7.8 短信 息 控件 的 属性 及 说 明 


属 性 说 明 属 人 性 说 H 
GoogleVoiceEnabled | 是 否 允 许 使 用 谷歌 语音 功能 | PhoneNumber 目标 电话 号 码 
Message 发 送 的 短信 息 内 容 ReceivingEnabled 是 否 人 允许 应 用 接收 短信 息 


ReceivingEnabled 属性 有 3 个 可 选 值 , 数 值 1, 表 示 忽 略 接收 短信 息 功 能 ;数值 2, 表 
示 程 序 运行 时 才 会 接收 短信 ;数值 3, 表 示 后 台 接 收 短信 ,即使 程序 已 经 退出 , 仍 会 接收 短 
信 。 后 台 接 收 短信 后 ,手机 就 会 在 通知 栏 内 显示 一 条 通知 ,选择 此 通知 后 ,程序 会 自动 被 
切换 到 前 台 。 

短信 息 控件 支持 MessageReceived 事件 ,在 接收 到 短信 息 后 产生 ,可 以 提取 短信 发 送 
方 的 号 码 (number) 和 短信 息 内 容 (messageText) ,如 图 7. 57 所 示 。 
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图 7.57 MessageReceived 事件 


短信 息 控件 支持 SendMessage 方法 ,用 来 发 送 短 信息 ,如 图 7. 58 所 示 。 在 调用 
SendMessage 方法 前 ,需要 在 PhoneNumber 属性 中 设 定 目 标 电话 号 码 , 在 Message 属性 


中 设 定 发 送 内 容 。 


图 7.58 SendMessage 方法 


7.2.6 电话 本 示例 


通讯 录 是 手机 中 使 用 最 为 频繁 的 软件 ,一 般 按 照 联 系 人 名 字 的 字母 顺序 排列 ,可 以 显 
示 联 系 人 的 姓名 头像 .手机 号 和 电子 邮件 地 址 等 信息 ,如 图 7. 59 所 示 。 用 户 选择 联系 人 
后 ,可 以 拨打 电话 或 发 送 短信 。 通 讯 录 的 数据 信息 保存 在 手机 的 数据 库 中 ,一般 通 过 共享 
机 制 ,允许 其 他 软件 读 取 数 据 库 中 的 联系 人 信息 。 

PhoneBook 是 个 通讯 录 应 用 的 示例 ,使 用 了 多 个 社交 控件 ,包括 选取 号 码 
(PhoneNumberPicker) ,拨号 (PhoneCall) 和 短信 息 (Texting) 。 

PhoneBook 示例 利用 选取 号 码 控 件 在 电话 簿 中 选取 目标 联系 人 的 电话 号 码 , 然 后 使 
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用 短信 息 控件 和 拨号 控件 对 此 号 码 发 送 短信 息 或 拨打 电话 。 需 要 注意 的 是 ,由 于 此 示例 
使 用 了 手机 间 的 通信 功能 ,所 以 需要 使 用 实体 手机 进行 调试 。 

PhoneBook 示例 是 一 个 简化 的 通讯 录 , 通 过 读 取 手 机 数据 库 中 的 联系 人 信息 ,可 以 
显示 联系 人 的 姓名 、 电 话 和 头像 .并 支持 拨打 电话 、 发 送 接收 短信 息 的 功能 。PhoneBook 
示例 的 运行 界面 如 图 7. 60 所 示 。 
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7.59 手机 通讯 录 图 7.60 PhoneBook 示例 运行 界面 


单 击 “ 选 取 联 系 人 ”按钮 ,将 弹出 手机 内 置 的 联系 人 选择 界面 ,如 图 7. 61 所 示 , 供 用 户 
选择 目标 联系 人 。 

选择 联系 人 “ 李 雷 ”,PhoneBook 示例 运行 界面 将 跳 转 回 启动 时 的 主页 面 ,此 时 “ 李 
雷 ” 的 头像 、 姓 名 和 电话 已 经 显示 在 界面 上 ,如 图 7. 62 所 示 。 
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图 7.61 手机 内 置 的 联系 人 选择 界面 图 7.62 “ 李 雷 ”信息 界面 
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此 时 单 击 “ 打 电话 ”按钮 ,将 直接 呼叫 李 硕 的 电话 号 码 ; 单 击 “ 发 短信 ”按钮 ,可 将 文本 
框 中 的 内 容 发 送 到 李 需 的 电话 号 码 上 。 需 要 注意 的 是 ,拨打 电话 和 发 送 短信 会 产生 一 定 
的 通信 费用 。 

PhoneBook 示例 的 界面 中 包含 两 个 非 可 视 化 控件 Texting1 和 PhoneCalll ,如 图 7. 63 所 
示 。 在 界面 编辑 器 中 ,不 用 修改 这 两 个 控件 的 任何 属性 。 
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图 7.63 PhoneBook 示例 界面 设计 图 


PhoneNumberPicker 控件 被 单 击 后 ,会 自动 出 现 联 系 人 选择 界面 ,因此 无 须 处 理 该 
控件 的 单 击 事件 。 用 户 选 择 好 联系 人 后 ,会 触发 AfterPicking 事件 ,将 电话 号 码 
PhoneNumber 赋值 给 全 局 变量 phoneNum, 供 拨打 电话 和 发 送 短 信 功 能 使 用 ;并 判断 
Picture 是 否 为 空 字符 串 ,如 果 非 空 , 则 将 联系 人 的 头像 Picture 赋值 给 图 像 控 件 Imangel 
的 Picture 属性 ,如 图 7. 64 所 示 。 

在 拨打 电话 前 ,要 先 设置 PhoneCalll 控件 的 PhoneNumber 属性 。 如 图 7.65 所 示 ， 
将 全 局 变量 phoneNum 中 保存 的 电话 号 码 赋 值 给 PhoneNumber 属性 后 ,就 可 以 调用 
MakePhoneCall 方法 拨打 电话 了 。 

发 送 短 信 功 能 中 有 一 个 小 技巧 ,就 是 避免 发 送 空 短信 。 首 先 判 断 短 信 内 容 是 否 为 空 ， 
如 果 短 信 内 容 不 为 空 , 才 可 以 进行 短信 发 送 过 程 。 发 送 短 信和 前 ,要 设置 Textingl 控件 的 
PhoneNumber 属性 和 Message 属性 ,然后 调用 SendMessage 方法 发 送 短信 ,如 图 7. 66 所 示 。 

短信 接收 功能 非常 简单 ,在 Textingl 的 MessageReceived 事件 中 ,将 事件 传递 的 
number( 短 信 发 送 者 电话 号 码 ) 和 messageText( 短 信 内 容 ) 显 示 在 标签 控件 LabelShow 
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MakePhoneCall 


图 7.65 拨打 电话 功能 
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7.66 短信 发 送 功能 


上 即 可 ,如 图 7.67 所 示 。 其 中 ,如 果 将 Textingl 的 ReceivingEnabled 参数 设置 为 2 
(foreground) ,表示 仅 在 应 用 程序 运行 期 间接 收 短信 息 。 
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图 7.67 短信 接收 功能 


PhoneBook 示例 的 全 部 逻辑 模块 如 图 7. 68 所 示 。 
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图 7.68 PhoneBook 示例 的 全 部 逻辑 模块 


OE 


. 音频 播放 器 控件 和 音效 控件 在 使 用 场合 和 使 用 方式 上 有 何 区 别 ? 
. 选取 联系 人 控件 的 功能 能 否 被 选取 号 码 控件 替代 ? 为 什么 ? 
. 尝试 使 用 选取 联系 人 和 语音 生成 控件 开发 一 个 具有 辅助 语音 功能 的 电话 短 。 
A. 语音 生成 控件 依赖 于 手机 内 置 的 TTS 扩展 服务 应 用 ,说 说 这 样 的 控件 与 以 往 介 
绍 的 控件 有 什么 不 同 。 
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数据 存储 与 访问 


AI2 提供 了 基于 本 地 数据 库 、 网 络 数 据 库 和 数据 融合 表 等 多 种 存储 方式 , 既 可 以 满足 
数据 持久 保存 的 需要 ,也 可 以 通过 网 络 实现 数据 共享 和 交换 。 通 过 本 章 的 学 习 , 读 者 可 以 
掌握 如 何在 手机 存储 器 和 网 络 中 存储 和 访问 数据 ,并 了 解 如 何 与 其 他 应 用 程序 共享 这 些 
数据 。 


本 章 主要 学 习 目 标 

° 了 解 本 地 数据 库 、 网 络 数 据 库 和 数据 融合 表 的 特点 
。 掌握 TinyDB 控件 的 使 用 方法 

* 掌握 TinyWebDB 控件 的 使 用 方式 

* 了 解 在 Google Drive 中 建立 数据 融合 表 的 方法 

* 掌握 FusiontableControl 的 使 用 方法 


81 本 地 数据 库 


8.1.1 简介 


数据 库 按照 数据 结构 来 组 织 、 存 储 和 管理 程序 内 部 的 数据 ,通过 对 数据 进行 集中 的 控 
制 来 保证 数据 的 一 致 性 和 可 维护 性 ,减少 数据 元 余 , 并 实现 用 户 和 应 用 间 的 数据 分 享 
功能 。 

对 于 大 型 软件 来 说 ,数据 库 设 计 是 开发 过 程 中 一 项 非常 烦琐 的 工作 ;但 在 移动 应 用 
开发 中 ,很 多 时 候 应 用 程序 只 需要 存储 一 些 简单 的 数据 ,如 账户 信息 、 运 行 记录 或 参数 
设 定 等 。 这 些 结构 数据 并 不 复杂 ,只 要 能 够 在 手机 中 长 期 存储 ,不 因 程 序 关 闭 而 被 清 
除 就 可 以 了 o 

为 了 满足 简单 的 存储 功能 ,AI2 提供 了 本 地 微型 数据 库 控件 TinyDB。TinyDB 是 一 
种 基于 NVP(Name/Value Pair, 标 签 / 值 对 ) 的 数据 存储 方式 ,用 户 无 须 了 解数 据 本 地 存 
储 的 技术 细节 ,只 要 利用 “标签 "就 可 以 在 数据 库 中 存储 或 读 取 数据 。 

在 本 地 微型 数据 库 中 ,每 个 数据 对 应 一 个 “标签 ”。 例 如 ,文本 数据 “Hello my AI2” 的 
标签 为 myString ,这 样 在 微型 数据 库 中 就 可 以 通过 标签 myString 检索 到 文本 数据 “Hello 
my AI2”。 当 然 , 在 数据 存储 的 时 候 , 也 要 为 所 有 数据 提供 唯一 的 标签 。 
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8.1.2 TinyDB 控件 


TinyDB 是 一 个 非 可 视 化 控件 ,如 图 8. 1 所 示 , 支 持 基于 NVP 的 本 地 数据 存储 。 
JT 


OD s sn nsn 支持 Midi» Non-visible components 
法 ,包括 ClearAll( 清 除 所 有 数据 )、ClearTag( 清 除 指定 Pn 
的 标签 ) .GetTags( 获 取 标签 列表 ) .GetValue( 获 取 数 = 
据 ) 和 StoreValue( 存 储 数据 ) ,如 图 8. 2 所 示 。 TinyDB1 

ClearAll 方法 可 以 清除 数据 库 中 的 全 部 数据 。 图 8.1 TinyDB 控件 


ClearTag 方法 可 以 根据 参数 tag 删除 指定 的 标签 ,可 
以 认为 删除 了 指定 标签 ,也 就 删除 了 指定 标签 所 对 应 的 数据 。GetTags 方法 可 以 用 来 获 
取 当 前 数据 库 中 所 有 标签 的 列表 。 
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图 8.2 TinyDB 的 方法 


StoreValue 方法 可 以 将 标签 (tag) 和 数据 (valueToStore) 一 同 保存 在 数据 库 中 ,被 保 
存 的 数据 可 以 是 数值 ,文本 或 是 列表 ,标签 可 以 是 数值 或 文本 ,例如 图 8. 3 所 示 。 


8.3 数据 存储 


GetValue 方法 可 以 根据 参数 tag 所 指定 的 标签 获取 数据 ,如 果 参 数 tag 指定 的 标签 
在 数据 库 中 不 存在 , 则 返回 valueIfTagNotThere 中 预先 设 定 的 默认 值 。 如 图 8. 4 所 示 ， 
调用 GetValue 方法 可 以 将 图 8. 3 中 存储 的 数据 从 数据 库 中 取出 ,为 了 避免 因 标签 不 存在 
无 法 获取 数据 ,这 里 在 valueIfTagNotThere 参数 中 根据 数据 类 型 不 同 而 设置 了 不 同 的 默 
认 值 。 如 果 获 取 的 数据 是 文本 , 则 默认 值 设置 为 空 文本 ;如 果 获 取 的 数据 是 列表 , 则 默认 
值 设 置 为 空 列 表 。 

数据 删除 可 以 通过 ClearAll 和 ClearTag 方法 实现 。 调 用 ClearAll 方法 后 ,数据 库 中 
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图 8.4 数据 获取 
的 所 有 标签 和 数据 都 会 被 清除 。 而 ClearTag 方法 则 可 以 删除 数据 库 中 的 一 条 数据 。 如 
图 8.5 所 示 , 即 表示 将 标签 Tom 传递 给 ClearTag 方法 , 则 将 数据 库 中 标签 为 Tom 的 数 


据 (*Tom”,“12 岁 ”) 删 除 。 如 果 数 据 库 中 不 存在 标签 为 Tom 的 数据 ,程序 也 不 会 报错 ， 
也 就 是 说 用 户 删除 标签 不 存在 的 数据 , 则 相当 于 执行 了 一 次 无 效 操作 。 
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8.5 数据 删除 


GetTags 方法 可 以 返回 当前 数据 库 中 的 所 有 标签 ,返回 值 的 形式 是 列表 。 如 图 8. 6 
所 示 ,数据 库 中 有 三 组 数据 (*a”,“12 岁 ”)、 
(2”“11 岁 ”) 和 (*0”,“15 岁 ”), 调 用 
GetTags 方法 后 返回 的 列表 为 (“0”.“2”， 
say E TinyDBl + NE 

这 里 需要 注意 的 是 ,在 一 个 应 用 程序 中 
使 用 多 个 TinyDB 控件 是 没有 意义 的 ,因为 
同一 个 应 用 程序 的 存储 空间 是 共享 的 ,即使 
用 到 了 多 个 TinyDB 控件 ,数据 也 是 存储 在 
一 起 ,标签 也 不 能 够 重复 ,否则 会 产生 数据 
覆盖 的 问题 。 另 外 ,不 同 应 用 的 数据 存储 空 
间 之 间 是 相互 独立 的 ,即使 使 用 了 相同 名 称 
的 TinyDB 控件 和 标签 ,也 无 法 进行 数据 的 交换 。 


8.1.3 ”本 地 微型 数据 库 示例 


下 面 通过 LocalMiniDB 示例 ,详细 介绍 如 何 使 用 TinyDB 控件 ,实现 本 地 微型 数据 库 
的 数据 添加 .索引 和 删除 等 功能 。LocalMiniDB 示例 的 运行 界面 如 图 8. 7 所 示 。 

LocalMiniDB 示例 中 ,在 “数据 内 容 " 文 本 框 中 输入 数据 , 单 击 “ 写 人 数据 ”按钮 可 以 将 
数据 存储 在 数据 库 中 。 为 了 操作 简单 ,这 里 只 允许 用 户 输入 数字 。 如 果 用 户 试图 向 数据 


TIT .StoreValue 


库 中 添加 空 数据 ,会 显示 浮动 提示 信息 “请 填写 
数据 内 容 ”。 在 数据 添加 成 功 后 ,会 在 “数据 库 操 
作 人 信息? 标签 中 显示 一 条 添加 成 功 信息 ,例如 * 添 
加 数据 (单条 ): (2.66683999)", 

LocalMiniDB 示例 的 界面 设计 如 图 8. 8 所 
示 。 单 击 “ 读 取 单 条 信息 ”按钮 会 弹出 选项 列表 ， 
选择 要 读 取 数 据 的 标签 ,就 可 以 在 “数据 库 操作 
信息 ”标签 中 显示 读 取 到 的 信息 ,例如 “ 读 取 数 据 
(单条 ): (5,54385)”。“ 读 取 全 部 信息 ”会 将 数据 
库 索 引 的 信息 显示 在 “数据 库 操作 信息 ”标签 中 ， 
例如 “ 读 取 数 据 ( 全 部 ):(7,5828)” 和 “ 读 取 数 据 
(全 部 ): (5,54385)”。 

单 击 “删除 单条 信息 ”按钮 也 通过 选项 列表 
选择 标签 ,然后 根据 标签 删除 数据 库 中 对 应 的 数 
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LocalMiniDB 


本 地 微型 数据 库 


新 数据 : | BURAS 写 入 数据 
读 取 单条 数据 读 取 全 部 数据 
删除 单条 数据 删除 全 部 数据 


数据 库 操作 信息 :清除 操作 信息 


删除 数据 (单条 ) : (1 ,一 ) 
添加 数据 (单条 ) : (2, 6668399 ) 
添加 数据 (单条) : (1,458558) 
读 取 数 据 ( 58) : (5,54385) 
读 取 数据 ( 全 部 ) : (7,5828) 
读 取 数据 ( 全部) : (5,54385) 


8.7 LocalMiniDB 示例 的 运行 界面 


据 。 单 击 “ 删 除 全 部 信息 ”按钮 可 以 删除 数据 库 中 所 有 的 数据 。 
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图 8.8 LocalMiniDB 示例 界面 设计 图 


“清除 操作 信息 ”按钮 用 来 清空 “数据 库 操作 信息 ”标签 中 的 显示 信息 ,并 不 对 数据 库 


进行 任何 操作 。 
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在 界面 编辑 器 中 , 须 将 文本 框 控件 TextBoxNew 的 NumbersOnly 属性 设 为 true, 限 
只 能 输入 数字 。 

在 模块 编辑 器 中 ,首先 定义 全 局 变量 Tag, 用 来 表示 数据 存储 的 标签 ,如 图 8. 9 所 示 。 

接 下 来 设计 如 何 使 用 全 局 变量 Tag 作为 标签 ,在 用 户 单 击 ButtonWrite 按钮 后 ,将 数 
据 写 和 人 数据库。 在 Button Write 按钮 单 击 事件 中 ,首先 判断 文本 框 TextBoxNew 是 否 为 
空 。 如 果 为 空 , 则 调用 通知 控件 Notifierl 的 ShowAlert 方法 ,弹出 浮动 的 提示 消息 ;如 果 
不 为 空 , 则 调用 微型 数据 库 控件 TinyDB1 的 StoreValue 方法 ,将 标签 (Tag) 和 数据 
(TextBoxNew. Text) 存 人 数据 库 。 全 局 变量 Tag 是 一 个 整数 标签 ,在 每 次 向 数据 库 中 添 
加 数据 前 ,会 自动 递增 1, 这样 可 以 保证 标签 不 会 重复 。 最 后 调用 自 定义 的 方法 
DisplayInfo 显示 相关 数据 ,如 图 8. 10 所 示 。 


ui 


m Click 
4» [CJ if [TextBox\ew “ Bl Text `] 
IL MET coal Tag PEU nm 


EET Dal Tas 7 


initialize globall 


图 8.9 自 定义 全 局 变量 Tag 8.10 ButtonWrite 按钮 单 击 事件 


如 图 8. 11 所 示 , 自 定义 的 方法 DisplayInfo 可 以 在 标签 控件 LabelInfo 中 显示 信息 ， 
信息 的 格式 为 “type: (tag,value)”, 例 如 ,“ 添 加 数据 (单条 ):(2,66683999)”“ 删 除数 据 
CER): (1,- 一 )” 或 “ 读 取 数 据 ( 全 部 ): (5,54385)”。 


Fd value + 


LabelInfo +Ë 


图 8.11 自 定义 方法 DisplayInfo 


LPReadOne 控件 是 选项 列表 控件 ,这 里 用 到 了 BeforePicking 和 AfterPicking 事件 。 
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BeforePicking 事件 中 调用 数据 库 TinyDB1 的 GetTags 方法 ,将 获取 数据 库 中 的 所 有 标 
签 , 并 在 选项 列表 LPReadOne 中 显示 。 在 AfterPicking 事件 中 ,LPReadOne. Selection 
是 用 户 在 选项 列表 中 选择 的 标签 ,微型 数据 库 TinyDB1 的 Get Value 方法 根据 用 户 选 择 
的 标签 获取 数据 库 中 特定 的 数据 ,如 图 8. 12 所 示 。 


ue 


图 8.12 LPReadOne 控件 事件 


LPDeleteOne 控件 也 是 选项 列表 控件 ,同样 用 到 了 BeforePicking 和 AfterPicking 事 
件 。AfterPicking 事件 中 调用 数据 库 TinyDB1 的 ClearTag 方法 ,会 将 用 户 选择 的 标签 
(LPDeleteOne. Selection) 在 数据 库 中 对 应 的 数据 删除 ,如 图 8. 13 所 示 。 


when .BeforePicking 


do set 


ee Me 


type 


图 8.13 LPDeleteOne 控件 事件 


要 获取 数据 库 中 的 全 部 数据 ,首先 要 调用 数据 库 控件 TinyDB1 的 Get Tags 方法 获得 
数据 库 中 的 所 有 标签 ,然后 通过 调用 for each in list 方法 遍历 刚刚 获取 到 的 标签 列表 ,再 
调用 GetValue 方法 将 数据 从 数据 库 中 逐 项 提取 出 来 .如 图 8. 14 所 示 。 

删除 数据 库 中 的 所 有 数据 非常 简单 ,只 要 调用 数据 库 控件 TinyDB1 的 ClearAll 方法 
即 可 ,如 图 8. 15 所 示 。 

要 清空 界面 上 的 操作 信息 ,只 要 将 标签 控件 LabelInfo 的 Text 属性 设置 成 为 空 文本 
即 可 ,如 图 8.16 所 示 。 

LocalMiniDB 示例 的 完整 逻辑 模块 如 图 8. 17 所 示 。 
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图 8.17 LocalMiniDB 示例 的 完整 逻辑 模块 
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8.2.1 简介 


本 地 微型 数据 库 可 以 实现 将 应 用 程序 的 数据 存储 在 手机 的 存储 器 中 ,这 样 的 存储 方 
式 虽 然 具 有 简单 .快捷 的 优点 ,但 不 能 实现 不 同 应 用 程序 间 的 数据 共享 和 数据 交换 。 

AI2 支持 网 络 数据 库存 储 和 访问 功能 ,可 以 将 应 用 程序 的 数据 通过 互联 网 存储 在 指 
定 的 服务 器 上 ,应 用 程序 可 以 根据 标签 获取 这 些 数据 ,从 而 实现 不 用 应 用 程序 间 的 数据 共 
享 和 交换 。 

网 络 数据 库 虽 然 功 能 强大 ,但 需要 用 户 自己 设置 和 部 署 数据 服务 ,相关 的 内 容 已 经 超 
越 本 书 的 范围 , 感 兴趣 的 读者 可 以 参考 网 站 http: //ai2. appinventor. mit. edu/reference/ 
other/tinywebdb. html. 

为 了 让 读者 可 以 使 用 网 络 数 据 库 ,而 不 必 过 多 涉及 开发 和 部 署 数据 服务 的 内 容 , 本 节 中 
使 用 AI2 提供 的 用 于 测试 目的 的 “数据 服务 ”(http://appinvtinywebdb.appspot.com) ,这 
个 数据 服务 可 以 被 所 有 开发 者 共享 ,如 图 8. 18 所 示 。 但 这 个 数据 服务 有 250 条 数据 的 使 
用 限制 ,所 以 “数据 服务 ”中 的 数据 会 在 短 时 间 内 被 其 他 数据 所 覆盖 。 


App Inventor for Android: Tiny WebDB Service 
e App Inventor 


NOTE: This service is being modified. It might go offline without notice 
This demonstration Web service is designed to work with App Inventor for Android and the TinyWebDB 
component. The site is designed for use by applications running on the phone (via JSON requests). You can 
also aa the get and store operations by hand from this Web page to test the API, and also delete 
individual entries. 


This service is only a demo. The database will store at most 250 entries; adding entries beyond that will 
cause the oldest entries to be deleted. Also, individual data values are limited to at most 500 characters. 


The source code for this service, designed to run on Google AppEngine, is included in the App Inventor 
documentation. You can use this implementation as a model for deploying your own services with larger 
capacity and additional features, and build applications that use the TinyWebDB component to talk to your 
service. 


Available calls: 
* /storeavalue: Stores a value, given a tag and a value 


* /getvalue: Retrieves the value stored under a given tag. Returns the empty 
string if no value is stored 


图 8.18 http://appinvtinywebdb. appspot. com 


因为 网 络 出 境 数据 的 屏蔽 问题 ,国内 无 法 直接 访问 这 个 网 络 数据 库 , 所 以 请 读者 自行 
实现 手机 的 “ 翻 墙 ” 功 能 后 ,再 尝试 本 节 后 面 的 电子 名 片 示 例 。 


8.2.2 TinyWebDB 控件 


TinyWebDB 属于 非 可 视 化 控件 ,可 以 实现 基于 NVP 的 网 络 数据 存储 ,如 图 8. 19 
所 示 。 
TinyWebDB 的 最 核心 属性 是 ServiceURL ,表示 网 络 数据 服务 的 位 置 ,如 图 8. 20 所 
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示 。 任 何 使 用 TinyWebDB 控件 的 应 用 程序 都 需要 设置 ServiceURL 属性 ,标识 出 与 之 通 
信 的 数据 服务 位 置 。ServiceURL 属性 的 默认 值 为 http://appinvtinywebdb. appspot. 
com, 是 AI2 提供 的 测试 数据 服务 链接 地 址 。 

Non-visible components 


TinyWebDBl E 


t 
TinywebDB1 EC JR 


图 8.19 TinyWebDB 控件 图 8.20 TinyWebDB 的 ServiceURL 属性 


TinyWebDB 仅 支 持 GetValue( 获 取 数 据 ) 方 法 和 StoreValue( 存 储 数据 ) 方 法 ,如 图 
8. 21 所 示 ,数据 的 存储 和 获取 都 基于 tag 标签 。 

与 TinyDB 不 同 ,TinyWebDB 的 这 两 个 方法 被 调用 后 ,因为 数据 要 经 过 网 络 传输 , 存 
储 或 访问 的 过 程 可 能 成 功 ,也 可 能 失败 ,因此 TinyWebDB 提供 了 3 个 事件 ,用 以 确认 
GetValue 和 StoreValue 方法 的 调用 是 否 成 功 。 

ValueStored 事件 和 GotValue 的 事件 如 图 8. 22 所 示 , StoreValue 方法 被 调用 后 ,如 
果 数 据 成 功 保存 在 网 络 数据 库 中 , 则 会 引发 ValueStored 事件 ;GetValue 方法 被 调用 后 ， 
如 果 从 网 络 数据 库 中 成 功 获 取 到 数据 , 则 会 引发 GotValue 事件 ,事件 中 的 参数 
tagFromWebDB 表示 获取 数据 的 标签 ,参数 valueFromWebDB 表示 获取 到 的 数据 。 


J - GetValue 


LUGE TinyWebDB1 ~” BEIM 


do 


tag 


.StoreValue 
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tag 


valueToStore 


图 8.21 TinyWebDB 的 方法 图 8.22 ValueStored 事件 和 GotValue 的 事件 


数据 的 存储 和 访问 过 程 受 到 网 络 状况 和 服务 可 用 性 等 方面 的 影响 ,可 能 会 导致 在 调 
用 GetValue 和 StoreValue 方法 后 ,没有 成 功 将 数据 存储 到 网 络 数 据 库 , 或 者 从 数据 库 中 
获取 数据 失败 ,此 时 会 引发 TinyWebDB 控件 的 WebServiceError 事件 ,参数 message 表 
示 引 发 异常 的 原因 ,如 图 8. 23 所 示 。 
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图 8. 23 WebServiceError 事件 
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8.2.3 电子 名 片 示例 


下 面 通过 eCard 示例 介绍 如 何 使 用 TinyWebDB 控件 ,实现 数据 的 网 络 存储 和 访问 。 
再 次 提醒 一 下 读者 ,这 个 示例 需要 手机 已 经 实现 了 “ 翻 墙 ”功能 ,否则 无 法 访问 AI2 提供 
的 公共 测试 数据 服务 。 

eCard 示例 实现 了 类 似 于 电子 名 片 的 功能 ,用 户 可 以 将 自己 的 信息 (姓名 十 简介 ) 提 
交 给 网 络 数据 库 ,数据 就 会 以 用 户 提供 的 “姓名 ”作为 标签 ,将 数据 完整 地 保存 在 网 络 数据 
库 中 ,并 供 其 他 用 户 检索 eCard 示例 的 运行 界面 如 图 8. 24 所 示 。 


电子 名 片 
@ompass 


姓名 : 请 输入 姓名 ( 中 文 或 英文 ) 


提交 
简介 : 请 输入 个 人 简介 
检索 姓名 : 请 输入 被 检索 人 的 姓名 检索 


图 8.24 eCard 示例 的 运行 界面 


如 图 8. 25 所 示 , 在 界面 编辑 器 中 ,供用 户 填写 姓名 、 简 介 和 检索 姓名 的 文本 框 控 件 名 
称 分 别 为 lbName、lbInfo 和 lbSearch, 用 来 显示 检索 结果 的 标签 控件 为 tbResult。 

在 模块 编辑 器 中 ,首先 设置 TinyWebDB 的 ServiceURL 属性 ,方法 是 在 屏幕 页 Screenl 
的 Initialize 初始 化 方法 中 ,将 ServiceURL 属性 设置 为 http://appinvtinywebdb. 
appspot. com, W A] 8. 26 所 示 。 

在 btSubmit 按钮 的 单 击 事件 中 ,首先 判断 用 户 的 输入 信息 是 否 完整 ,也 就 是 要 判断 
文本 框 控件 tbName 和 tbInfo 的 Text 属性 是 否 为 空 文本 。 如 果 用 户 输入 的 信息 不 完整 ， 
则 使 用 Notifierl 控件 的 ShowMessageDialog 方法 弹出 提示 对 话 框 ,告知 用 户 要 “输入 完 
整 的 个 人 信息 ”。 如 果 用 户 已 经 输入 了 完整 的 信息 , 则 可 以 调用 TinyWebDB1 控件 的 
StoreValue 方法 ,以 tbName 文本 框 的 Text 属性 作为 tag 标签 ,将 数据 存储 到 网 络 数据 
库 中 。 最 后 清空 用 户 输入 的 数据 信息 ,即将 tbName 和 tbInfo 的 Text 属性 设置 为 空 文 
本 ,如 图 8. 27 所 示 。 

在 数据 成 功 存储 到 网 络 数 据 库 后 ,会 引发 TinyWebDB1 控件 的 ValueStored 事件 。 
在 该 事件 中 会 弹出 对 话 框 , 用 以 确认 数据 已 经 成 功 存储 ,如 图 8. 28 所 示 。 
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8.25 eCard 的 界面 编辑 器 设置 


when Initialize 


tbNeme + BM Text - 


图 8. 27 btSubmit 按钮 的 单 击 事件 
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图 8.28 数据 存储 成 功 


为 了 在 数据 存储 失败 时 给 用 户 以 提示 ,在 TinyWebDB1 控件 的 WebServiceError 事 
件 中 会 弹出 带 有 “网 络 错误 ”的 提示 对 话 框 ,并 将 错误 信息 message 显示 在 对 话 框 中 ,如 
图 8.29 所 示 。 
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get 


buttonText 


图 8.29 异常 产生 


在 btSearch 按钮 的 单 击 事件 中 ,同样 要 判断 “检索 姓名 ”的 信息 是 否 完整 ,如 果 不 完 
整 要 提示 用 户 “ 输 入 被 检索 人 员 的 姓名 ”。 如 果 信 息 完 整 , 则 以 文本 框 tbSearch 的 Text 
属性 作为 标签 ,调用 GetValue 方法 在 网 络 数据 库 获 取 数 据 , 如 图 8. 30 所 示 。 


when Click 


it 


buttonText 


图 8. 30 btSearch 按钮 的 单 击 事件 


TinyWebDB1 控件 成 功 获取 到 数据 后 ,GotValue 事件 会 将 返回 的 数据 直接 显示 在 标 
4& tbResult 中 ,同时 清空 文本 框 tbSearch 中 用 户 输入 的 “检索 姓名 ”, 如 图 8.31 所 示 。 
eCard 示例 的 完整 逻辑 模块 结构 如 图 8. 32 所 示 。 
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LUE TinyWebDB1 + Era G 


MEE valueFromWebDB - 


8.32 eCard 示例 的 完整 逻辑 模块 


83 RMSE 


8.3.1 简介 


数据 融合 表 (Fusion Tables) 是 谷歌 推出 的 可 视 化 数据 服务 ,支持 表格 式 数据 的 存 
储 、 查 询 、 导 入 导出 和 管理 功能 ,并 针对 大 数据 集 进行 优化 ,支持 100MB 的 表格 数据 ,采用 
开放 的 API 接口 ,支持 CSV 和 XLS 格式 。 

如 图 8. 33 所 示 ,数据 融合 表 更 加 接近 于 数据 库 , 只 是 按照 固定 格式 来 存储 数据 ,着 重 
于 对 数据 进行 批量 操作 ,例如 分 类 、 筛 选 、. 聚 合 或 合并 ,也 可 以 通过 可 视 化 组 件 呈 现 数据 、 
图 表 和 地 理 位 置信 息 ,在 数据 分 析 和 处 理 方面 有 着 强大 的 功能 。 


8.3.2 创建 数据 融合 表 


数据 融合 表 是 Google Drive 上 提供 的 一 项 服务 。 如 图 8.34 所 示 Google Drive 功能 
非常 强大 ,可 以 让 用 户 随时 随地 从 云端 存 取 文件 ,支持 Android, OS X. iOS 和 Windows 
系统 ,可 通过 Google Docs 进行 文档 协作 编辑 ,也 可 直接 在 云端 创建 文档 。Google Drive 
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可 以 在 Gmail 中 直接 插入 Google Drive 的 分 享 链接 ,也 可 以 直接 将 Google Drive 里 的 视 
频 和 图 片 分 享 到 Google 十 上 面 。Google Drive 具有 超 强 的 搜索 功能 ,通过 关键 字 和 各 种 
过 滤 选 项 可 以 快速 找到 需要 的 文档 ,甚至 Google Drive 能 分 辨 图 片 和 文档 里 的 图 片 内 
容 , 支 持 Photoshop Illustrator 和 高 清 视 频 文件 格式 。 


eTable 
Add Attribution - Edited at 4:47 PM 
File Edit Tools Help 
No filters applied 

M * 19of9 P » 
Name Info 
EIRT — SXTG—CUMT 
diss 今夜 下 雨 了 心情 不 好 
WA 今天 我 的 手机 又 挂 了 
小 明 我 已 经 六 年 级 了 
TER REFRE 
韩 梅 梅 。 ”英语 教材 中 的 女孩 
oz01 你 们 猜 我 星 谁 
PE 。 “我 今天 工作 了 
Tom a lovely boy 


Bf Cards 1 


Time 

2014 年 1 月 6 日 AM10:38:00 
2014 年 1 月 22 日 PM4:43:05 
20143311A PM1:41:23 
20144522A PM427 13 
20144522H PM4:31:17 
2014 年 3 及 29 日 PM3:11:42 
2014 年 4 月 23 日 PM2:22:22 
201443148 AM9:23-12 


20143528A AM10:13:54| 


图 8.33 数据 融合 表 


Google Drive 


Keep everything. Share anything. 


BEOBmMEZU 


图 8.34 Google Drive 


Google Drive 的 地 址 是 https: //drive. google. com, 这 个 网 站 已 被 屏蔽 ,因此 读者 需 
要 “ 翻 墙 " 后 才能 够 访问 。 图 8. 35 所 示 是 用 户 使 用 Gmail 账号 登录 Google Drive 后 所 显 
示 的 页 面 ,根据 用 户 所 在 地 区 不 同 所 显示 的 语言 也 不 尽 相 同 。 


目 ves Nos es 

人 Tutino Brochure pit 

El Frat Budge see 

I3 Datasheets ec 
Project Baracuda overvew 

目 pemwcm sw 


i Final Video = 


IE 2 C a rapa googiecom = 
Sao Lii = R- 
Drive 四 Proci paracuca 92686000 - 9 =E > 


omer. LASTM. 
Bobby Brenmt 246 pm e 
me 246 p 


Meredih Blad 211pm 
me 147pm 


me 11:52am se 


Eric Shoemak 11:41 am 


JewSme Nov 12 ~ 


图 8.35 用 户 登录 后 的 Google Drive 
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通过 左上 方 的 创建 (CREATE) 按 钮 可 以 创建 数据 融合 表 。 如 果 数 据 融合 表 不 在 创 
建 按钮 的 下 拉 列 表 中 ,可 以 选择 下 拉 列 表 最 下 方 的 “关联 更 多 应 用 ”项 ,将 数据 融合 表 关 联 
到 谷歌 的 云端 硬盘 ,如 图 8. 36 所 示 。 


将 应 用 关联 到 云端 硬盘 x 
| | Google 云端 硬盘 数 BER 实验 性 ) = 
É | P | eek aie | +ë 35 


图 8.36 关联 数据 融合 表 


Google Drive 支持 多 种 方式 创建 数据 融合 表 , 如 图 8. 37 所 示 , 可 以 从 本 地 计算 机 中 
上 传 数据 文件 生成 数据 融合 表 , 支 持 csv、tsv 和 txt 格式 的 文件 ;也 可 以 使 用 Google 
Spreadsheets 生成 数据 融合 表 ; 还 可 以 直接 建立 空 表 格 , 然 后 通过 Web 的 方式 添加 数据 。 


Import new table 


| For vis comuer E Ro 


H, : You can upload spreadsheets, delimited text fles ( csv, sv, or i, 
HI] Google Spreadsheets and Keyhole Markup Language files (km) Leam more 


J create emoy tabe 


Or search public data tables 


New to Fusion Tables? Cancel 


Take a peek! Play with a data set or try a tutonal 


图 8.37 创建 数据 融合 表 的 3 种 方式 


笔者 这 里 选择 通过 单 击 图 8. 37 所 示 页 面 中 的 Create empty table 按钮 创建 空 数据 融 
合 表 ,建立 的 数据 融合 表 如 图 8. 38 所 示 。Google Drive 将 创建 的 空 数据 融合 表 命 名 为 
New Table 


Edited at 10:53 PM 


File Edit Tools Hep | Æ Rows1 ~ | BFECards1 9 Map of Location n 


No filters applied 


R < 11031 国 » 


Text Number Location Date 


Hi8.38 ” 空 数据 融合 表 
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New Table, 并 自动 创建 了 4 个 数据 项 名 Text, Number, Location 和 Date, Google Drive 
支持 表格 方式 (Rows) ,卡片 方式 (Cards) 和 地 图 方式 (Map of Location) 3 种 方式 显示 数 
据 , 图 8. 38 所 使 用 的 就 是 表格 方式 。 

如 果 需 要 添加 或 修改 数据 项 ,可 以 参考 图 8. 39 所 示 的 方法 ,选择 Edit 菜单 命令 或 单 
击 数据 项 名 , 即 可 选择 不 同 的 操作 方法 来 实现 。 


II 


File Edit Toos Hep | ÆRc Fie Edit Tools Help 


Add row No filters applied 
p | =t% M o* 11of1 » » 
Tex DuPicate row Text Number Location Date 
| Delete selected row Change... 
| Delete all rows Find... 
Add column [e o 
Add formula column Sort 1 to 100 
| Change columns Seid 


图 8.39 修改 数据 项 


如 果 需 要 对 数据 项 进行 更 复杂 的 操作 , 则 需要 在 Edit 菜单 中 选择 Change columns 
菜单 项 ,将 会 出 现 数据 项 的 修改 页 面 ,如 图 S. 40 所 示 。 这 个 页 面 支持 数据 项 的 删除 ,更改 
顺序 .添加 描述 ,修改 名 称 、 修 改 数据 类 型 和 格式 等 。 数 据 融合 表 支 持 的 数据 类 型 有 文本 
(Text) ,数字 (Number) , H # (Date/Time) #1% # (Location) 。 


x 
Change columns 
E 
Number Number | Mame 
[Text 
Location Location 
Date Date/Time | Descnphon 
Type 
Tet $ 
Format 
Noe $ 
Data entry Leammore 
@ validate data 
List of drop-down items 
P 
ave Cancel 


图 8.40 数据 项 修改 页 面 
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笔者 将 表 命 名 为 eTable, 创 建 了 3 个 数据 项 ,名 称 为 Name, Info 和 Time, 类 型 都 是 
文本 (Text) ,如 图 8. 41 所 示 。 


Change columns 


++ 
Name 
Info Text 
Name 
Time Text 
Description 


图 8.41 笔者 建立 的 数据 融合 表 


在 数据 融合 表 建立 后 ,通过 Edit 菜单 中 的 Add row 命令 ,可 以 向 表 中 添加 数据 。 添 
加 数据 的 页 面 如 图 8.42 所 示 。 


Add new row 
Name [1 NH ji 
Info — 辐 机 师 博 去 阳光 花园 


Time [2014848223 7) 


Save and add another — Cancel 


图 8.42 添加 数据 的 页 面 


在 向 表 中 多 次 添加 数据 后 ,生成 了 类 似 如 图 8. 43 所 示 的 数据 融合 表 。 这 个 表 在 本 节 
后 面 的 电子 留言 板 示例 中 会 用 到 。 


Name 而 Info | Time 

ERT 。 今天 我 第 一 次 器 了 2014 年 1 月 6 日 AM10:38:00 
拖 克 今夜 下 雨 了 心情 不 好 ”2014 年 1 月 22 日 PM4:43:05 
阿 贵 今天 我 的 手机 又 挂 了 ， 2014 年 3 月 119 PM1:41:23 
小 明 司机 师傅 去 阳光 花园 ” 2014 年 4 月 22 日 PM4:27:13 


BER RE RRM 20144422H PM4:31:17 
韩 梅 梅 。 ”英语 教材 中 的 女孩 。 2014 年 3 月 29 日 PM3:11:42 
oz01 你 们 猜 我 是 谁 2014 年 4 月 23 日 PM2-22:22 


图 8.43 笔者 的 数据 融合 表 


最 后 要 让 其 他 人 可 以 分 享 数据 ,需要 设 定数 据 融合 表 的 权限 。 方 法 是 通过 单 击 右 上 
方 的 “分 享 按 钮 ,弹出 如 图 8. 44 所 示 的 权限 设置 页 面 。 在 权限 设置 页 面 中 ,“ 要 共享 的 链 
接 ” 是 供 其 他 用 户 访问 的 数据 融合 表 地 址 ;“ 有 权 使 用 的 人 ”选项 栏 中 ,除了 表格 的 创建 者 
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具有 使 用 权限 外 ,用 户 还 可 以 选择 将 数据 融合 表 设 置 为 公开 、 邀 请 链接 和 私密 3 种 模式 。 
笔者 选择 了 邀请 链接 ,任何 获得 此 链接 的 用 户 ,都 可 以 在 浏览 器 中 直接 访问 笔者 的 数据 融 
合 表 。 如 果 设 置 为 私密 , 则 只 有 数据 融合 表 的 创建 者 可 以 使 用 ;如 果 设置 为 公开 , 则 互联 
网 上 的 任何 人 都 可 以 查询 和 访问 。 


共享 链接 的 方式 ; 

有 权 使 用 的 人 

& 。 知道 此 诗 接 的 任何 人 都 可 以 查看 更 改 
& warnersuper@gmailcom (您 ) warnersupe 为 所 有 者 
邀请 其 他 人 


输入 姓名 、 电 子 邮件 地 址 或 群 组 


有 权 编 辑 的 人 可 以 加 和 并 更 改 文件 的 权限 设置 。 喝 鸡 ] 


图 8.44 权限 设置 页 面 


图 8. 44 中 显示 的 邀请 链接 并 不 完整 ,完整 的 邀请 链接 为 https://www. google. com/ 
fusiontables/ DataSource? docid = 1YyiE6lqCbBZ3xuVyMjFM4OxiwnrttR72aKRxklWx, 其 中 
数据 融合 表 的 ID 为 1YyiE61qCbBZ3xuVyMjFM4OxiwnrttR72aKRxklWx。 


8.3.3 建立 API key 


在 AI2 中 要 访问 Google Drive 中 的 数据 融合 表 , 不 仅 要 在 谷歌 的 开发 者 控制 台 
(Developers Console) 中 开启 数据 融合 表 的 API, 还 要 生成 供 Android 设备 使 用 的 
API key. 

开启 数据 融合 表 的 API, 只 要 在 谷歌 开发 者 控制 台中 将 Fusion Tables API 的 
STATUS 状态 更 改 为 “ON” 即 可 ,如 图 8. 45 所 示 。 开 发 者 控制 台 的 登录 地 址 为 http:// 
code. google. com/apis/console.f£& FH Gmail 账号 登录 即 可 ,如 果 用 户 没有 创建 项 目 , 首 先 
要 创建 一 个 项 目 , 笔 者 的 项 目 名 称 为 miniwebdb。 

只 要 在 Credentials 页 面 的 Simple API Access 栏 中 单 击 Create new Android key 按 
钮 即 可 生成 供 Android 设备 使 用 的 API key, 如 图 8. 46 所 示 。 

笔者 建立 的 API key 为 AlzaSyBsp0mLON_t99w2nk6AerKE4wX-rk5Qas4, 如 图 8. 47 所 
示 。 这 个 API key 在 后 面 的 电子 留言 板 示例 中 会 使 用 到 。 
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Google Developers Console S O 
< miniwebdb NAME QUOTA STATUS 
Overview Fusion Tables API 0% EN 
APIs & auth Ad Exchange Buyer API 1,000 requests/day OFF 
AER Ad Exchange Seller API 10,000 requests/day OFF 
Credentials 
Consent screen Admin SDK 150,000 requestsiday OFF 
ren AdSense Host API 100,000 requests/day OFF 
图 8.45 开启 Fusion Tables API 
Simple API Access 


Use API keys to identify your project when you do not need to access user data. Leam more 
Create new Server key... | Create new Browser key... | Create new Android key... | Create new iOS key... | 


Notification Endpoints 


Use notification endpoints to identify domains that may receive webhook notifications from your API. Learn more 


Allowed Domains: No domains allowed 


Edit. 


8.46 创建 API key 


Public API access Key for Android applications 
Use ofthis key does not require any 

user action or consent, does not API key 

grant access to any account 

information, and is not used for yok pcalons 
authorization SEE 


Learn more 


Activated by 
CREATE NEW KEY 


AIzaSyBspOnLON t99w2nk6AerKEdwX-rk5Qasd 
Any application allowed 
Apr 21, 2014 5:23 PH 


warnersupergmail.com (you) 


Edit allowed Android applications ^ Regeneratekey — Delete 


图 8.47 笔者 的 API key 


8.3.4 FusiontablesControl 控件 


FusiontablesControl 属于 非 可 视 化 控件 ,可 以 实现 对 Google Drive 中 数据 融合 表 的 


访问 ,如 图 8. 48 所 示 。 


FusiontableControl 控件 支持 的 属性 有 ApiKey Non-visible components 


和 Query, 如 图 8. 49 所 示 。ApiKey 是 必须 设置 的 
属性 ,表明 该 应 用 程序 是 否 具有 访问 Google Drive 
的 权限 。 

属性 Query 用 来 承载 SQL 语句 ,实现 查询 、 


FusiontablesControl1 
图 8. 48  FusiontablesControl 控件 
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图 8. 49  FusiontableControl 控件 的 属性 


修改 和 更 新 等 功能 。 数 据 融合 表 的 SQL 语句 规范 可 以 参考 网 站 https://developers. 
google. com/fusiontables/docs/v1/sql-reference。 下 面 用 两 个 小 例子 说 明 如 何 使 用 SQL 
语句 。 

向 数据 融合 表 中 添加 数据 的 SQL 语句 为 INSERT INTO 1YyiE6lqCbBZ3xuVy- 
MjFM4OxiwnrttR72aKRxklWx (Name. Info. Time) VALUES (*oz01”,“ 你 们 猜 我 是 
谁 '",“ 2014 4E 4 H 23 日 PM2:22;22’)。 在 这 个 SQL 语句 中 , INSERT INTO VALUES 是 
添加 数据 的 SQL 语句 ; 1YyiE6lqCbBZ3xuVyMjFM4OxiwnrttR72aKRxklWx 是 数据 融 
合 表 的 ID; (Name. Info, Time) 是 数据 项 名 ;(“oz017",“ 你 们 猜 我 是 谁 *,“2014 年 4 月 
23 日 PM2:22:227) 是 一 条 完整 的 数据 ,文本 数据 要 用 单 引号 标识 。 

从 数据 融合 表 中 获取 最 后 10 条 数据 的 SQL 语句 为 SELECT * FROM 
1YyiE6lqCbBZ3xuVyMjFM40xiwnrttR72aKRxklWx ORDER BY Time DESC LIMIT 
10。 在 这 个 SQL 语句 中 ,SELECT * FROM 是 获取 数据 的 SQL 语句 ;1YyiE6lqCbBZ3- 
xuVyMjFM4OxiwnrttR72aKRxklWx 是 数据 融合 表 的 ID; ORDER BY Time 表示 根据 数 
据 项 Time 排序 ;DESC 表示 逆序 显示 ;LIMIT 10 表示 最 多 获取 10 条 数据 。 

在 Query 属性 中 填写 后 ,就 可 以 执行 FusiontableControl 控件 的 SendQuery 方法 ,来 
实际 执行 数据 操作 ,如 图 8. 50 所 示 。 也 就 是 说 ,只 设置 Query 属性 并 不 会 执行 任何 操 
作 , 只 有 在 调用 SendQuery 方法 后 才 会 执行 具体 操作 。 


图 8. 50 FusiontableControl 控件 的 方法 


ForgetLogin 方法 可 以 让 应 用 程序 忽略 手机 上 的 谷歌 账号 信息 ,要 求 用 户 在 访问 数 
据 融合 表 的 时 候 重 新 进行 认证 。DoQuery 方法 是 旧版 的 SQL 语句 执行 操作 , 现 已 被 
SendQuery 方法 替代 。 

在 调用 SendQuery 方法 后 ,无论 是 正常 完成 数据 融合 表 的 操作 ,还 是 出 现任 何 类 型 
的 错误 ,GotResult 事件 都 会 被 调用 ,如 图 8. 51 所 示 。 参 数 result 是 事件 返回 的 信息 ,可 
以 是 操作 结果 、 获 取 的 数据 或 错误 信息 。 例 如 在 添加 数据 的 操作 中 ,如 果 操 作成 功 , 参 数 
result 会 返回 类 似 于 “rowid 2001” 的 提示 信息 ;如 果 操 作 失 败 , 则 会 给 出 失败 原因 ,例如 
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“Read timed out", 
8.3.5 电子 留言 板 示例 


本 节 中 将 通过 eBoard 示例 演示 如 何 使 用 FusiontablesControl 控件 实现 Google 
Drive 中 数据 融合 表 的 数据 存储 和 获取 ,如 图 8. 52 所 示 。 本 示例 使 用 的 数据 融合 表 是 在 
8.3.2 节 创 建 的 ,使 用 的 API key 是 在 8. 3. 3 节 申 请 的 。 本 示例 在 实际 测试 过 程 中 ,由 于 
网 络 速度 和 稳定 性 直接 决定 是 否 可 以 获取 数据 ,因此 读者 可 以 尝试 在 不 同 网 络 或 不 同时 
段 进 行 测试 。 


eBoard 


姓名 : 


smsa: TOND y 


结果 : 

Name,Info,Time 

pz01, 你 们 猜 我 是 谁 ,2014 年 4 月 23 日 PM2:22:22 
雷 五 龙 , 龙 生 中 段 腿 ,2014 年 4 月 22 日 PM4:31:17 
小 明 ,司机 师傅 去 阳光 花园 ,2014 年 4 月 22 日 
PM4:27:13 

梦 宇 ,我 今天 工作 了 ,2014 年 4 月 14 日 AM9:23:12 


Wit FusiontablesControll * Messi 


图 8.51 FusiontableControl 控件 的 GotResult 事件 图 8.52 eBoard 示例 的 运行 界面 


eBoard 示例 实现 了 “电子 留言 板 ” 的 功能 ,用 户 可 以 将 自己 的 姓名 和 留言 存储 在 建立 
的 数据 融合 表 中 ,用 户 也 可 以 从 数据 融合 表 中 获取 一 定数 量 的 数据 。eBoard 示例 界面 设 
计 如 图 8.53 所 示 。 

在 eBoard 的 界面 编辑 器 中 ,FusiontablesControl 控件 的 Query 属性 默认 值 为 show 
tables, 这 个 值 可 以 不 必修 改 , 后 面 在 模块 编辑 器 中 会 进行 修改 。 时 钟 控件 Clockl 用 来 获 
取 当 前 时 间 , 因 此 该 控件 的 默认 属性 也 不 必修 改 。 

在 模块 编辑 器 中 ,首先 在 屏幕 页 Screenl 的 Initialize 事件 中 设置 FusiontablesControl 
控件 的 ApiKey 属性 ,使 用 笔者 申请 的 ApiKey。 然 后 调用 FusiontablesControl 控件 的 
ForgetLogin 方法 ,要 求 用 户 在 访问 数据 融合 表 时 重新 认证 ,如 图 8. 54 所 示 o 

在 后 面 的 多 个 模块 中 都 会 使 用 到 笔者 建立 的 数据 融合 表 的 ID, 因 此 建立 一 个 全 局 变 
量 Table ID 表示 数据 融合 表 ID, 如 图 8. 55 Bros 

在 btSubmit 按钮 的 单 击 事件 中 ,首先 检查 用 户 填写 的 信息 是 否 完成 ,如 果 不 完整 ,要 
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8.53 eBoard 的 界面 设计 图 
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图 8.54 Initialize 事件 


initialize global Table 


图 8.55 全 局 变量 Table ID 


用 对 话 框 提示 用 户 重新 填写 。 在 信息 完整 的 情况 下 ,将 “姓名 ”和 “内 容 ” 信 息 拼 装 成 添加 
数据 的 SQL 语句 ,并 调用 SendQuery 方法 执行 Query 属性 中 的 SQL 语句 ,如 图 8. 56 
所 示 。 

自 定义 方法 Quotify 有 两 个 作用 ,一 个 是 在 文本 前 后 添加 上 单 引 号 , 另 一 个 是 将 文本 
中 的 单 引 号 替换 为 双 引 号 ,如 图 8.57 所 示 。 因 为 在 SQL 语句 中 ,文本 信息 要 用 单 引 号 括 
起 来 ,而 且 在 文本 中 不 能 够 再 出 现 多 余 的 单 引 号 ,所 有 文本 内 的 单 引 号 要 被 蔡 换 成 双 


引号 。 
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8.56 btSubmit 按钮 的 单 击 事件 


to ED 
result join “ 国 ” 
text "| 
segment “P” 


replacement 


图 8.57 自 定义 方法 Quotify 


在 btSearch 按钮 的 单 击 事件 中 , 先 根据 标签 LabelNumber 的 Text 属性 表示 的 数值 ， 
拼装 成 获取 数据 的 SQL 语句 ,然后 调用 SendQuery 方法 执行 SQL 语句 ,如 图 8. 58 所 示 。 


when 


do KB ” 
[CM global Table ID + 


LabelNumber + Ë 


8.58 btSearch 按钮 的 单 击 事件 


在 所 有 FusiontablesControll 控件 执行 过 SendQuery 方法 后 ,都 要 引发 一 个 GotResult 
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事件 。 在 GotResult 事件 中 ,为 了 简化 应 用 程序 的 设计 ,只 是 将 结果 result 显示 在 标签 控 
fF tbResult 中 ,而 没有 根据 返回 值 具体 区 分 SQL 语句 是 否 执行 成 功 ,如 图 8. 59 所 示 。 


Lord FusiontablesControll 攻占 


图 8. 59 GotResult 事件 


PositionChanged 事件 是 Sliderl 被 滑动 时 引发 的 事件 ,只 要 根据 滑 块 的 值 设 置 标签 
LabelNumber 的 Text 属性 即 可 。 但 要 注意 的 是 ,为 了 生成 有 效 的 SQL 语句 ,要 求 只 能 
获取 整数 值 , 因 此 调用 round 方法 将 滑 块 thumbPositon 转换 为 整数 值 ,如 图 8. 60 所 示 。 


bt Sliderl + Baz u Ear: 


一 


图 8.60  PositionChanged 事件 


eBoard 示例 的 完整 逻辑 模块 结构 如 图 8. 61 所 示 。 


8.61 eBoard 示例 的 完整 逻辑 模块 结构 


CASE 


1. 对 比 本 地 数据 库 、 网 络 数据 库 和 数据 融合 表 , 分 析 这 几 种 存储 方式 的 特点 。 

2. 使 用 本 地 数据 库 建 立 、 保 存 应 用 程序 的 配置 信息 ,例如 界面 背景 颜色 .字体 大 小 和 
字体 颜色 等 。 

3. 尝试 建立 数据 融合 表 ,实现 网 络 多 人 聊天 室 。 
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网 络 通信 与 地 图 应 用 


网 络 通 信和 地 图 应 用 是 当前 较为 流行 的 开发 领域 ,有 非常 广泛 的 市 场 需求 。 通 过 本 
章 学 习 , 读 者 可 以 掌握 如 何 获 取 Web 服务 的 数据 、 使 用 蓝牙 技术 进行 短 距离 通信 以 及 使 
用 谷歌 地 图 开发 地 图 应 用 开发 。 


本 章 学 习 目标 

。 了解 Web 服务 和 蓝牙 技术 
+ 掌握 Web 控件 的 使 用 方法 
。 理 解 位 置 传感器 用 途 

。 掌握 蓝 下 控件 的 使 用 方法 
。 掌握 谷 歌 地 图 的 使 用 方法 
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9.1.1 数据 服务 


互联 网 中 存在 着 大 量 有 用 的 数据 ,大 家 比较 熟悉 的 方法 是 通过 网 页 浏览 器 获取 这 些 
数据 。 例 如 ,用 户 在 网 页 浏览 器 地 址 栏 中 输入 https: //hk. finance. yahoo. com/q? s= 
GOOG&ql 二 1, 就 可 以 从 雅虎 香港 网 站 上 获取 谷歌 公司 的 股票 数据 信息 ,如 图 9. 1 所 示 。 


Google Inc. (GOOG) - NesdaqGs MOERS C mA AUR] 


535.000 . 5.950(1.100%) 045114, EHA. 24:45 - ñispm pass ig 
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ure wwe “Bess stadt tlh NGOOG 4 月 11 0945EDT 
Bi: 532.540 52 gii 526.610 - 604.830. s 
RB 530.250 x 100. 成 交 量 : 603,575 540 
EHE: 530.730 x 200 Pas (3 个 2,412,400 535 
1 年 指标 ( 预 估 值 ) Aaa 一 一 一 一 一 一 一 一 一 so 
市 值 : 359.57B 
Beta iB: 1154 Yahoo! i l 525 
— P/E (ttm): 28.140 1000 12:00 1400 1600 
下 一 个 一 利 日 : 不 得 用 et — 
SEER (tm): K sebe 
BARE: FA FA) PESH ME 


图 9.1 在 浏览 器 中 的 谷歌 股票 信息 
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随 着 数据 分 享 的 需求 不 断 增加 ,用 户 已 经 不 再 满足 于 在 网 页 浏览 器 中 获取 数据 ,需要 
一 种 便捷 的 方法 直接 获取 到 这 些 关键 数据 , 随 之 便 出 现 了 Web 服务 (Web Service) 。 如 
果 通 过 网 页 浏览 器 获取 数据 是 “人 对 机 器 ”的 方式 ,那么 Web 服务 就 是 “机 器 对 机 器 ”的 方 
式 。 许 多 Web 服务 提供 了 应 用 程序 接口 (API) ,使 手机 应 用 程序 可 以 直接 访问 这 些 APT 
获取 数据 。 下 面 以 雅虎 的 金融 API 为 例 ,说 明 如 何 通过 API 获取 谷歌 股票 信息 数据 。 如 
果 需 要 获取 最 近 的 谷歌 股票 信息 ,可 以 使 用 链接 http://finance. yahoo. com/d/quotes. 
csv?f 二 11&s 二 GOOG。 在 这 个 链接 中 ,“GOOG” 表 示 谷 歌 公司 的 股票 代码 ;“f 二 11” 表 示 
获取 最 近 一 次 数据 ;返回 的 数据 是 CSV 格式 (用 空格 分 隔 多 个 数据 ) 文 件 ,这 里 返回 的 就 
是 一 个 数据 "535”。 雅 虎 的 金融 API 的 详细 说 明 可 参考 网 站 http://www. gummy-stuff. 
org/ Yahoo-data. htm, 


9.1.2 Web 控件 


在 AI2 中 ,如 果 要 从 Web 服务 的 API 中 获取 数据 ,就 需要 使 用 Web 控件 。Web 控 
件 是 一 个 非 可 视 化 控件 ,提供 后 台 获 取 数 据 的 功能 ,包括 HTTP GET, POST, PUT 和 
DELETE, 如 图 9. 2 所 示 。 

Web 控件 支持 5 个 属性 ,包括 AllowCookies, Request Headers, ResponseFileName, 
SaveResponse 和 Url, 属 性 说 明 如 表 9. 1 所 示 。 


表 9.1 Web 控件 属性 及 说 明 


属 性 说 明 
AllowCookies 是 否 保存 响应 信息 的 cookies 
RequestHeaders 请 求 头 信息 
Non-visible components SaveResponse 是 否 将 返回 的 信息 存储 在 一 个 文件 中 
.- ResponseFileName | 返回 信息 存储 文件 的 位 置信 息 
有 Url request 请 求 的 Url 值 


Web 控件 支持 获取 文件 (GotFile) 和 获取 文本 (GotText) 事 件 ,如 图 9.3 所 示 。 两 个 
事件 都 表示 数据 请 求 完成 ,只 数据 返回 形式 不 同 。 获 取 文 件 事件 用 来 获取 响应 数据 文件 
的 位 置信 息 ;获取 文本 事件 用 来 获取 响应 数据 的 文本 数据 。 其 中 ,参数 url 表示 原始 请 求 
所 使 用 的 url;responseCode 表示 数据 请 求 的 结果 ,用 一 个 数字 表示 请 求 成 功 或 为 什么 请 

when (AIE . CotFile 
do 


IE NES 


do 


图 9.3 Web 控件 的 事件 
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求 失败 ,例如 200 表示 请 求 成 功 ,404 表示 请 求 的 页 面 没 有 找到 ,更 加 详细 的 信息 可 以 参 
考 网 站 http://en. wikipedia. org/wiki/List of HTTP status codes;responseType 表示 
返回 的 数据 类 型 ,例如 “text/csv” 表 示 获 取 到 csv 格式 的 文本 数据 “image/jpeg” 表 示 获 
取 到 jpeg 格式 的 图 像 文件 ,更 加 详细 的 信息 可 以 参考 网 站 http://en. wikipedia. org/ 
wiki/Mime_type。 

如 果 属 性 SaveResponse 设置 为 false, 表 示 响 应 数据 不 保存 为 文件 ,在 获取 文本 事件 
的 参数 responseContent 中 ,将 获取 到 响应 数据 的 文本 信息 ;如 果 属 性 SaveResponse 设置 
为 true, 表 示 响 应 数据 将 保存 为 文件 ,在 获取 文件 事件 的 参数 fileName 中 将 获取 到 的 响 
应 数据 保存 在 本 地 的 文本 位 置信 息 , 而 获取 文本 事件 的 参数 responseContent 将 获取 不 


到 任何 数据 。 


Web 控件 支持 的 方法 较 多 ,具体 如 表 9. 2 所 示 。 


39.2. Web 控件 方法 及 说 明 


方 法 说 明 

BuildRequestData 将 有 两 个 元 素 的 子 列表 的 转换 为 格式 化 的 字符 串 

ClearCookies 清空 Cookies 

Delete 根据 属性 Url 的 值 执行 一 个 HTTP DELETE 的 请 求 , 并 得 到 一 个 新 的 应 答 
执行 一 个 HTTP GET 请 求 ,并 根据 属性 SaveResponse 获取 响应 。 如 果 

Get SaveResponse 为 true. 将 响应 保存 成 文件 ,并 引发 GetFile 事件 ; 如果 
SaveResponse 为 false, 将 引发 Text 事件 

HtmlTextDecode 对 html 文本 值 进行 解码 

JsonTextDecode 对 Json 文本 值 进行 解码 

根据 属性 值 Url 执行 一 个 HTTP POST 请 求 ,path 参数 指定 Post 文件 的 
PostFile 路 径 
PostText 根据 属性 值 Url 执行 一 个 HTTP POST HR ,text 参数 指定 Post 的 文本 值 


PostTextWithEncoding 


根据 属性 值 Url 执行 一 个 HTTP POST 请 求 ,text 参数 指定 Post 的 文本 内 
容 , 文 本 内 容 使 用 encoding 指定 的 参数 进行 编码 


PutFile 


根据 属性 值 Url 执行 一 个 HTTP PUT 请 求 , path 参数 指定 Post 文件 的 
路 径 


PutText 


根据 属性 值 Url 执行 一 个 HTTP POST 请 求 ,text 参数 指定 Post 的 文本 
值 ,text 的 内 容 使 用 UTF-8 编码 


PutTextWithEncoding 


根据 属性 值 Url 执行 一 个 HTTP POST 请 求 ,text 参数 指定 Post 的 文本 
值 ,text 的 内 容 使 用 encoding 指定 的 编码 方式 编码 


UriEncode 


编码 字符 串 ,使 它 可 以 在 URL 中 使 用 


9.1.3 


票 高 手 示例 


下 面 通过 WebStock 示例 说 明 如 何 使 用 Web 控件 从 雅虎 金融 API 中 获取 股票 数据 
信息 ,并 将 这 些 信 息 以 图 表 的 形式 显示 出 来 。 
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WebStock 示例 的 运行 界面 如 图 9. 4 所 示 ,示例 中 获取 了 六 个 公司 的 股票 信息 ,分 别 是 
谷歌 CGOOG) .IBM(IBM) \ 埃 克 森 美孚 (XOM) 、 强 
生 (JNJ)、 微 软 (MSFT) 和 卡特 彼 勒 (CAT)。 如 
图 9.5 所 示 , 用 户 单 击 “ 获 取 股 票数 据 ”" 按 钮 后 ， 6oo6 : 540.95 股票 高 手 
这 些 数 据 会 显示 在 界面 上 方 的 数据 显示 区 ,同时 KO: bd 
这 些 数据 所 生成 的 图 表 会 显示 在 界面 的 下 方 。 UNJ: 96.54 

在 界面 编辑 器 中 ,Web 控件 的 属性 AllowCookies Dar: sona 


CAT : 102.26 
设置 为 false. 属性 ResponseFileName 设置 为 EE 
Z8 ,属性 SaveResponse 设置 为 false, 属 性 Url it CN 
置 为 空 , 如 图 9. 6 所 示 。 P: 


在 逻辑 编辑 器 中 ,首先 处 理 “ 获 取 股 票数 据 ” | ao 
按钮 (Button1) 的 单 击 事件 。 在 按钮 的 单 击 事件 


中 ,首先 设置 Webl 控件 的 属性 Url 的 值 , 将 其 | so| 
设置 http://finance. yahoo. com/d/quotes. 


csv? [= 18s = GOOG + IBM + XOM + JNJ + 
MSFT 十 CAT, 如 图 9.7 所 示 。 这 个 使 用 雅虎 金 C GOOG IBM XOM JNJ MSFT CAT 
融 API 的 链接 结构 前 面 的 内 容 中 介绍 过 ,不 同 
之 处 在 于 最 后 的 “GOOG 十 IBM 十 XOM 十 JNJ 十 
MSFT 十 CAT”, 表 示 同 时 获取 6 个 公司 的 股票 数据 信息 。 


图 9.4 WebStock 示例 的 运行 界面 
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数据 图 形 : 


ResponseFileName 


Rename Delete Í 
Non-visible components SaveResponse 
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Upload File 一 


图 9.5 WebStock 示例 界面 设计 图 图 9.6 ”Web 控件 的 属性 设置 


可 视 化 开发 Android 应 用 程序 
— tš | ++ X HEX App Inventor 2 (第 2 路 ) 


when Click 


do 


set 


call 


图 9.7 Buttoni 的 单 击 事件 


设置 Webl 控件 的 属性 Url 后 ,就 可 以 调用 Webl 控件 的 Get 方法 向 服务 器 提交 
请 求 。 

在 服务 器 将 响应 数据 返回 应 用 程序 后 ,就 会 引发 GotText 事件 ,返回 的 数据 保存 在 
参数 responseContent 中 。 为 了 确定 返回 的 数据 是 否 有 效 , 要 先 判断 GotText 事件 的 参 
数 responseCode 的 值 是 否 为 200,200 表示 数据 请 求 成 功 。 如 果 请 求 数据 成 功 , 则 可 以 将 
参数 responseContent 传递 给 自 定 义 函 数 DisplayValue 和 DisplayChart, 用 于 在 界面 中 显 
示 数 据 和 图 表 , 如 图 9. 8 所 示 。 参 数 responseContent 中 的 数据 形式 类 似 “546. 29 196. 52 
97. 355 97. 42 39. 60 102. 67”, 为 了 便于 自 定义 函数 处 理 数据 ,调用 split at spaces 方法 将 
这 些 数字 按 空格 拆 分 成 列表 (546. 29.196. 52,97. 355.97. 42,39. 60.102. 67) 。 


Ni .GotText 


PT responsecoce - Jf 


图 9.8 GotText 事件 


自 定义 函数 Display Value 的 功能 是 将 Web 控件 获取 的 数据 显示 在 对 应 的 控件 上 ， 
如 图 9. 9 所 示 。 自 定义 函数 的 参数 valueList 是 列表 形式 的 信息 ,使 用 select list item 方 
法 ,根据 索引 值 ,将 参数 valueList 中 的 所 有 数据 显示 在 不 同 的 标签 上 。 


select list item list 
index 


select list item list 


select list i 

inde: 
select list item 

i 


select list item list 


index 


select list item list 


图 9.9 DisplayValue 函数 
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自 定 义 函 数 DisplayChart 的 功能 是 将 Web 控件 获取 的 数据 显示 成 为 图 表 , 如 图 9. 10 
所 示 。 这 个 自 定义 函数 定义 了 一 个 局 部 变量 piece, 并 使 用 for each 模块 遍历 的 列表 参数 
valueList, 将 列表 参数 valueList 中 的 数据 拼接 成 以 逗号 作为 间隔 的 字符 串 , 并 将 这 个 字 
符 串 赋 值 给 局 部 变量 piece。if…then 模块 的 作用 就 是 避免 拼接 处 理 的 字符 串 最 后 一 个 
字符 是 逗号 。 最 后 设置 图 像 控 件 Imagel 的 Picture 属性 ,设置 的 值 是 一 个 http 链接 地 
址 ,使 用 的 是 Google Chart API, 


9.10 DisplayChart 函数 


Google Chart API 是 谷歌 提供 的 图 表 生 成 服务 ,可 以 通过 URL 传递 参数 ,动态 生成 
饼 图 .柱状 图 .折线 图 和 散 点 图 等 图 表 , 如 图 9. 11 所 示 。 
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1300 1200 
2008 
4,000 1.000 
700 aco 2008 
400 600 
2010 
100 so 
2004 2005 2008 2007 2008 200 2010 204 400 soo 700 1000 1300 
Column Chart Area Chart. Candlestick Chart. 
4.200 1.200 2o 
Z le DOQNT 
700 800 ^o m 
aoo aoo 20 
400 400 ° 
2008 2009 2000 2011 2004 — 2006 — 2000 — 2007 Mon Wed FA 
Tues Tun 


图 9.11 Google Chart API 


传递 给 Google Chart API 的 URL 为 http //chart. apis. google. com/chart? cht = 
bvg8&chs— 300x200 8-chxt— x. y&-chxr—1.0.10008-chxl—0:; | GOOG| IBM| XOM [JNJI 
MSFT|CATë chd=t:。 在 这 个 URL rp, "cht— bvg" An ÆRE 5" chs — 300x200" R 
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—Lt IE] + £ # A App Inventor 2 (£ 244) 


示 生 成 的 图 表 尺 寸 为 300 X 200; *chxt— x.y" RR 1000 
要 显示 xy 轴 坐 标 ;*chxr 王 1,0,1000? 表 示 在 x 轴 
上 显示 刻度 范围 为 0~1000;“chxl=0: |GOOG| 500 
IBM| XOM | JNJ | MSFT|CAT” 表 示 在 y 轴 显 示 goo 
6 个 公司 的 股票 代码 ;chd=t:” 是 要 显示 的 数据 ， 
其 中 “t”" 是 代表 文本 数据 格式 ,与 参数 piece 拼接 好 400 
后 ,完整 的 格式 应 该 为 “chd 一 t: 546. 29,196. 52, 00 
97. 355,97. 42, 39. 60,102. 67”。 生 成 的 图 表 如 


图 9.12 所 示 。 


? GooG IBM XOM JNJ MSFT CAT 


WebStock 示例 的 全 部 逻辑 模块 如 图 9. 13 


所 示 。 


图 9. 12 Google Chart 生成 的 图 表 


图 9.13 WebStock 示例 的 全 部 逻辑 模块 


92 牙牙 通信 
9.2.1 技术 简介 


如 图 9. 14 所 示 ,蓝牙 (Bluetooth) 是 一 种 支持 设备 短 距 离 通 信 ( 一 般 10m 内 ) 的 无 线 
电 技术 ,支持 移动 电话 `.PDA 、 无 线 耳 机 ,笔记 本 电脑 、 相 关外 设 等 众多 设备 之 间 进 行 无 线 


C Bluetooth” 


图 9.14 蓝牙 


信息 交换 。 蓝 牙 技术 可 以 有 效 地 简化 移动 终端 设备 之 间 
的 通信 ,也 能 够 简化 设备 与 互联 网 之 间 的 通信 ,从 而 使 数 
据 传输 变 得 更 加 迅速 高 效 。 例 如 把 蓝牙 技术 引入 手机 和 
笔记 本 电脑 中 ,就 可 以 省 去 手机 与 笔记 本 电脑 之 间 的 连接 
电缆 ,直接 通过 蓝牙 的 无 线 通道 进行 数据 传输 。 

蓝牙 技术 规定 两 个 设备 进行 蓝牙 通信 时 ,必须 将 设备 
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分 为 “ 主 端 " 和 “从 端 " 才 可 以 。 蓝 牙 设备 可 以 在 两 个 角色 间 切 换 , 平 时 工作 在 从 端 模式 ,等 
待 其 他 主 设备 来 连接 ;需要 时 可 以 转换 为 主 端 模式 ,向 其 他 设备 发 起 呼叫 请 求 。 蓝 牙 通 信 
前 必须 由 主 端 进行 “查找 ” ,发 起 “配对 ”过程 ,连接 成 功 后 双方 才 可 收发 数据 。 

为 了 让 两 个 设备 在 查找 过 程 中 可 以 发 现 对 方 ,需要 将 蓝牙 设置 成 为 可见” 模式 ,如 
图 9.15 所 示 。 这 个 “可 见 ” 模 式 一 般 有 2 分 钟 的 时 限 , 超 过 这 个 时 限 ,蓝牙 又 自动 变 回 “ 不 
可 见 ” 的 模式 。 

然后 找 出 周围 处 于 “可 见 ” 模 式 的 蓝牙 设备 ,在 找到 目标 设备 后 ,就 可 以 发 起 “配对 ”请 
求 ,如 图 9. 16 所 示 。 


@ 蓝牙 配对 请 求 


要 与 以 下 设备 配对 : 
super warner (GT-19300 


Morc 请 确保 其 显示 的 配对 密 铀 为 : 
我 的 设备 194436 


super warner (GT-I9300 
取消 


图 9.15 蓝牙 的 可 见 性 设置 图 9.16 蓝牙 配对 请 求 


配对 请 求 会 同时 出 现在 两 个 手机 设备 上 ,并 显示 * 配 对 密 钥 ”。 在 用 户 确认 进行 配对 
后 ,配对 过 程 就 完成 了 ,信任 信息 会 被 记录 下 来 ,这 样 在 下 次 呼叫 时 则 不 再 需要 重新 配对 。 

蓝牙 设备 以 主 端 模式 发 起 呼叫 时 ,需要 知道 对 方 的 蓝牙 地 址 、 配 对 密码 等 信息 。 在 通 
信 状 态 下 , 主 端 和 从 端 设备 都 可 以 发 起 断 链 请 求 , 用 以 断 开 蓝牙 链 路 。 


9.2.2 蓝牙 控件 


在 AI2 中 ,支持 蓝牙 通信 的 控件 有 蓝牙 客户 端 (BluetoothClient) 和 蓝牙 服务 端 
(BluetoothServer) ,都 是 非 可 视 化 控件 ,如 图 9. 17 
所 示 。 蓝 牙 客 户 端 用 来 发 起 通信 连接 请 求 , 而 蓝牙 
服务 端 则 负责 接受 通信 连接 请 求 。 

AddressesAndNames 属性 是 蓝牙 客户 端的 专 
有 属性 ,表示 已 配对 蓝牙 设备 的 地 址 和 名 称 。 蓝 牙 
客户 端 和 蓝牙 服务 端的 共有 属性 如 表 9. 3 所 示 。 

蓝牙 客户 端的 专 有 方法 是 Connect 和 IsDevicePaired ,如 图 9. 18 所 示 。Connect 方法 
通过 指定 蓝牙 地 址 address 与 男 一 个 蓝牙 设备 建立 连接 ;IsDevicePaired 方法 用 来 检测 是 
否 与 指定 的 设备 完成 配对 。 


Non-visible components 


B B 


BluetoothClient1 BluetoothServer1 
图 9.17 蓝牙 客户 端 和 蓝牙 服务 端 控 件 
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表 9.3 蓝牙 客户 端 和 蓝牙 服务 端的 共有 属性 


属 性 说 明 
CharacterEncoding | 接收 信息 的 字符 编码 方式 
DelimiterByte 使 用 ReceiveText, ReceiveSignedBytes , ReceiveUnsignedBytes 等 方法 时 的 结束 符 
HighByteFirst 是 否 采用 高 位 优先 传递 的 传输 方式 
Secure 是 否 采 用 简易 安全 配对 机 制 
Available Android 设备 的 蓝牙 可 用 性 
Enabled 蓝牙 功能 是 否 启用 
IsConnected 是 否 已 建立 连接 


. Connect 


address 


DevicePaired 


address 


图 9.18 蓝牙 客户 端的 专 有 方法 


蓝牙 服务 端的 专 有 方法 是 AcceptConnection 和 StopAccepting. 如 图 9. 19 所 示 。 
AcceptConnection 方法 用 来 接受 外 部 蓝牙 连接 ;StopAccepting 方法 表示 不 再 接受 外 部 连 


BluetoothServerl v BEUSI I UAA il 


serviceName 


图 9.19 蓝牙 服务 端的 专 有 方法 


蓝牙 客户 端 和 蓝牙 服务 端的 共有 方法 如 表 9.4 所 示 。 
表 9.4 蓝牙 客户 端 和 蓝牙 服务 端的 共有 方法 


方 法 


说 明 


AcceptConnectionWithUUID 


接受 指定 uuid 的 蓝牙 连接 请 求 


BytesAvailableToReceive 


在 不 阻塞 的 情况 下 可 接收 的 字 节 数 ( 估 计 值 


Disconnect 


断 开 已 经 连接 的 蓝牙 设备 


ReceiveSignedl ByteNumber 


从 连接 的 蓝牙 设备 接收 一 个 字 节 长 度 的 有 符号 数 


ReceiveSigned2ByteNumber 


从 连接 的 蓝牙 设备 接收 两 个 字 节 长 度 的 有 符号 数 


ReceiveSigned4ByteNumber 


从 连接 的 蓝牙 设备 接收 四 个 字 节 长 度 的 有 符号 数 
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续 表 
方 法 说 明 
ReceiveSignedByt 从 连接 的 蓝牙 设备 接收 多 个 字 节 的 有 符号 数 的 值 , 如 果 
TEE Ee MS pad numberOfBytes 小 于 0, 则 一 直 读 取 直 到 遇 到 结束 符 
从 连接 的 蓝牙 设备 接收 一 个 字符 串 , 如 果 numberOfBytes 小 
ReceiveText 


于 0, 则 一 直 读 取 直 到 遇 到 结束 符 


ReceiveUnsignedl ByteNumber 从 连接 的 蓝牙 设备 接收 一 个 字 节 长 度 的 无 符号 数 


ReceiveUnsigned2ByteNumber 从 连接 的 蓝牙 设备 接收 两 个 字 节 长 度 的 无 符号 数 


ReceiveUnsigned4ByteNumber 从 连接 的 蓝牙 设备 接收 四 个 字 节 长 度 的 无 符号 数 


ReceiveUnsignedBytes 


从 连接 的 蓝牙 设备 接收 多 个 字 节 的 无 符号 数 的 值 , 如 果 
numberOfBytes 小 于 0, 则 一 直 读 取 直 到 遇 到 结束 符 


Send1ByteNumber 向 连接 的 蓝牙 设备 发 送 一 个 字 节 长 度 的 数 
Send2ByteNumber 向 连接 的 蓝牙 设备 发 送 两 个 字 节 长 度 的 数 
Send4ByteNumber 向 连接 的 蓝牙 设备 发 送 四 个 字 节 长 度 的 数 
SendBytes 向 连接 的 蓝牙 设备 发 送 列表 

SendText 向 连接 的 蓝牙 设备 发 送 字符 串 


蓝牙 客户 端 没有 可 以 支持 的 事件 ,蓝牙 服务 端 只 支持 ConnectionAccepted 事件 ,如 
图 9. 20 所 示 。ConnectionAccepted 事件 在 蓝牙 端 服 务 端 同意 蓝牙 客户 端的 连接 请 求 后 


产生 。 


LAUNE BluetoothServerl * MICAS ON | 


图 9.20 蓝牙 服务 端的 ConnectionAccepted 事件 


9.2.3 蓝牙 通信 示例 


下 面 通过 Bluetooth 示例 说 明 如 何 使 用 
蓝牙 客户 端 和 蓝牙 服务 端 ,实现 一 个 简单 的 蓝 
牙 聊 天 软件 ,如 图 9.21 所 示 。 示 例 的 昵称 是 
随机 产生 的 ,用 于 标识 在 聊天 过 程 中 的 不 同 
用 户 。 

Bluetooth 示例 将 蓝牙 客户 端 和 蓝牙 服务 
端 集成 在 一 个 应 用 程序 中 。 在 示例 启动 后 ,会 
在 应 用 的 上 方 显示 “蓝牙 应 用 ”的 字样 , 当 完 成 
蓝牙 连接 后 ,会 根据 角色 显示 “蓝牙 客户 端 "或 
“蓝牙 服务 端 ”, 如 图 9.22 所 示 。 

Bluetooth 示例 进行 调试 时 需要 两 部 手 


Bluetooth 


蓝牙 应 用 
© Bluetooth” 


上 昵称 : | 用 户 3359 | 


连接 断 开 清空 
Hello 发 送 
消息 记录 : 
初始 化 … 


图 9.21 Bluetooth 示例 的 运行 界面 
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Bluetooth 


5841]: 
用 户 3359]: 我 会 带好 十 人 的 
essen 今天 可 能 会 下 雨 


o accept a connection from a bluetooth device. 


用 户 3359 与 蓝牙 服务 端 连 接 成 功 


iut HEEC-23:3D:8D:66:88 HUAWEI Y300-0000 A ESE 
get... " 


9]: 你 好 
错误 代码 509 AcceptConnection 错 误 信息 : Unable [用户 5841]: 今 天 可 能 会 下 十 


Bluetooth 


Q Bluetooth” 


蓝牙 服务 端 


RH: 用 户 5841 
连接 KA 清空 
发 送 
— 
消息 记录 : 


用户 5841] 好 的 ，oz01 
[用 户 3359]: 我 会 带好 雨伞 的 


[用 户 3359]: 你 好 
用 户 3359 与 蓝牙 服务 端 连接 成 功 


图 9.22 蓝牙 连接 的 不 同 角色 


机 ,不 但 要 开启 手机 的 蓝牙 功能 ,还 要 完成 蓝牙 的 配对 过 程 。 
在 完成 蓝牙 的 配对 后 , 单 击 Bluetooth 示例 界面 上 的 “连接 ”按钮 ,选择 已 经 完成 配对 


的 蓝牙 设备 连接 地 址 ,如 图 9. 23 所 示 。 


如 果 两 个 手机 的 蓝牙 连接 成 功 ,示例 的 “消息 记 


录 ” 栏 中 将 显示 如 图 9. 24 所 示 的 提示 信息 。 


Bluetooth 


EC:23:3D:8D:66:88 HUAWEI 


Y300-0000 


9.23 蓝牙 设备 连接 地 址 


肖 息 记录 : 

误 代码 509 AcceptConnection 错 误 信息 : Unable 
lo accept a connection from a bluetooth device. 

户 3359 与 蓝牙 服务 端 连接 成 功 

试 连 接 EC:23:3D.8D.66:88 HUAWEI Y300-0000 
始 化 .… 


9.24 蓝牙 连接 成 功 


如 图 9. 25 所 示 , 在 界面 编辑 器 中 ,将 蓝牙 客户 端 和 蓝牙 服务 端 控 件 的 
CharacterEncoding 属性 设置 为 UTF-8 ,保证 蓝牙 通信 可 以 发 送 中 文 信息 ;DelimiterByte 
属性 的 值 设 置 为 0;Secure 属性 的 值 设 置 为 true, 启 用 简易 安全 配对 机 制 。Clockl 控件 的 
TimerAlwaysFires 设置 为 true; TimerEnabled 设置 为 false; TimerInterval 属性 的 值 设 置 


为 1000。 


在 逻辑 编辑 器 中 ,首先 定义 全 局 变量 isServer, 用 来 判定 在 蓝牙 连接 过 程 中 的 角色 ， 


初始 值 设 置 为 false, 如 图 9.26 所 示 。 


屏幕 页 的 初始 化 过 程 中 ,首先 使 用 random integer 方法 生成 随机 了 昵称 ,昵称 的 形式 是 
“用 户 十 数字 ”, 例 如 “用 户 1200? 或 "用户 3323”。 然 后 调用 自 定义 函数 Init, 如 图 9. 27 所 示 。 

自 定 义 的 Init 函数 主要 用 来 初始 化 一 些 基 础 设置 ,除了 在 屏幕 页 初始 化 的 时 候 会 被 
调用 ,在 蓝牙 连接 失败 和 断 开 蓝牙 连接 时 也 都 会 被 调用 。 如 图 9. 28 所 示 ,在 Init 函数 中 ， 
首先 调用 蓝牙 服务 器 的 Acceptconnection 方法 清空 蓝牙 的 外 部 服务 名 称 , 将 蓝牙 服务 器 
恢复 到 未 连接 状态 ;然后 设置 全 局 变量 isServer 为 false; 再 设置 Clockl 的 TimerEnabled 
属性 为 false, 停 止 时 钟 运行 ;最 后 调用 自 定义 的 Log 函数 ,将 “初始 化 …” 显 示 在 界面 上 。 
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图 9.25 Bluetooth FPR Tri T 


random integer from 


图 9.27 屏幕 页 的 初始 化 过 程 


图 9.28 自 定义 的 Init 函数 
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自 定义 的 Log 函数 可 以 将 参数 text 中 的 文字 显示 在 应 用 程序 界面 的 “消息 记录 ” 栏 


中 ,如 图 9.29 所 示 。Log 函数 在 本 示例 中 使 用 非常 广泛 ,不 仅 可 以 显示 调试 信息 、 蓝 牙 的 
连接 情况 ,还 可 以 显示 用 户 的 聊天 记录 等 内 容 。 


LabelResult + Ë 


图 9.29 自 定义 的 Log 函数 


在 用 户 单 击 “ 连 接 ” 按 钮 后 ,会 首先 引发 选项 列表 ListPickerConnect 的 BeforePicking 
事件 ,如 图 9. 30 所 示 。 在 BeforePicking 事件 中 ,设置 选项 列表 ListPickerConnect 中 的 
列表 项 ,为 蓝牙 客户 端 中 已 经 配对 设备 的 地 址 (BluetoothClient1. AddressesAndNames); 
并 判断 蓝牙 客户 端 是 否 可 用 (BluetoothClient1. Enabled) ,如 不 可 用 , 则 弹出 “请 开启 手机 
的 蓝牙 功能 ”浮动 消息 。 


when HET . BeforePicking 
do set 


"luetoothClientl * I AddressesándNames > 
not [Enabled `] 


owAlert 


notice 


图 9.30  BeforePicking 事件 
在 用 户 从 选项 列表 ListPickerConnect 中 选择 需要 连接 的 蓝牙 设备 地 址 后 ,会 引发 选 
项 列表 ListPickerConnect 的 AfterPicking 事件 ,如 图 9. 31 所 示 。AfterPicking 事件 首先 
判断 蓝牙 服务 器 模块 是 否 正在 接受 其 他 应 用 的 蓝牙 客户 端 模块 的 连接 (BluetoothServerl. 
IsAccepting) ,如 果 是 , 则 停止 连接 过 程 (BluetoothServerl. StopAccepting) 。 


EE Ficker: .AfterPickine 


图 9.31 AfterPicking 事件 
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然后 ,根据 选项 列表 ListPickerConnect 中 的 选择 调用 蓝牙 客户 端的 Connect 方法 ， 
根据 蓝牙 地 址 信息 连接 蓝牙 服务 器 。 因 为 蓝牙 服务 器 可 能 没有 启动 或 者 其 他 原因 导致 连 
接 失 败 ,所 以 根据 蓝牙 客户 端 Connect 方法 的 返回 值 判断 连接 过 程 是 否 成 功 。 如 果 连 接 
失败 , 则 调用 自 定 义 的 Init 函数 ;如 果 连 接 成 功 ,要 调用 自 定义 的 Send 函数 向 蓝牙 服务 端 
发 送 连接 成 功 信 息 , 并 调用 自 定义 的 Connected 函数 ,更 改 界 面部 分 按钮 的 可 点 击 状态 ， 
启动 时 钟 。 

自 定义 的 Connected 函数 主要 功能 是 根据 参数 status (布尔 值 ) 修 改 界 面 * 连 接 ” 按 
钮 “ 断 开 ?按钮 和 "发 送 ? 按 钮 的 可 点 击 状态 ,并 控制 时 钟 的 启动 和 停止 ,如 图 9. 32 所 示 。 


图 9.32 自 定义 的 Connected 函数 


如 果 应 用 程序 的 角色 是 蓝牙 服务 端 , 在 同意 蓝牙 客户 端的 连接 请 求 后 ,会 引发 
ConnectionAccepted 事件 ,如 图 9. 33 所 示 。 在 ConnectionAccepted 事件 中 ,全 局 变量 
isServer 会 被 设置 成 true, 表示 角 色 变 更 为 “蓝牙 服务 端 "; 然 后 同样 会 调用 自 定义 的 
Connected 函数 修改 按钮 的 可 点 击 性 和 启动 时 钟 。 


Lit BluetoothServerl + MERA AO a=: 


图 9.33 蓝牙 服务 端 ConnectionAccepted 事件 


在 时 钟 Clock1 的 Timer 事件 中 ,如 果 全 局 变量 isServer 的 值 为 true, 则 调用 蓝牙 服 
务 端的 数据 接收 函数 ;如 果 全 局 变量 isServer 的 值 为 false, 则 调用 蓝牙 客户 端的 数据 接 
收 函 数 。 在 调用 数据 接收 方法 ReceiveText 前 , 先 要 调用 BytesAvailableToReceive 方法 
获取 可 接收 的 数据 量 ,然后 根据 这 个 “可 接收 的 数据 量 ” 接 收 蓝牙 通信 的 数据 ,如 图 9. 34 
所 示 。 

在 发送" 按钮 ButtonSend 的 单 击 事件 中 调用 自 定义 的 Send 函数 ,可 将 固定 格式 的 
信息 发 送 到 蓝牙 连接 的 另 一 端 ,信息 的 格式 是 “[ 昵 称 ] :信息 ”, 如 图 9. 35 所 示 。 

自 定义 的 Send 函数 首先 要 判断 发 送 者 的 角色 ,如 果 是 蓝牙 服务 端 , 则 调用 服务 端的 
SendText 孙 数 ;如 果 是 蓝牙 客户 端 , 则 调用 客户 端的 Send Text 函数 ,如 图 9. 36 所 示 。 同 
时 ,还 要 把 发 送 的 信息 显示 在 “消息 记录 ” 栏 中 。 
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Timer 


if [zloba 


when mm 


[expvessaee > Text -] 


图 9.35 “发 送 "按钮 的 单 击 事件 


图 9.36 自 定 义 的 Send 函数 


“ 断 开 ” 按 钮 ButtonDisconnect 的 单 击 事件 直接 调用 自 定义 的 Disconnect 函数 ,如 
图 9.37 所 示 。 


bl ButtonDisconnect * MOE. 


do call 
An, 


图 9.37 “ 断 开 ”按钮 的 单 击 事件 
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自 定义 的 Disconnect 函数 也 要 根据 角色 调用 不 同 的 Disconnect 方法 ,并 调用 自 定义 
的 Connected 函数 和 Init 函数 ,如 图 9. 38 所 示 。 


P [34 global isServer " 


DORTE Bluetooth: rl * .Di 
w 


else call 
一 


call 


status false " 


图 9.38 自 定义 的 Disconnect 函数 


“清空 ”按钮 ButtonClear 的 单 击 事件 只 是 将 标签 LabelResult 的 Text 属性 设置 为 
空 , 用 以 清除 “消息 记录 ”中 的 所 有 信息 ,如 图 9. 39 所 示 。 


Lit ButtonClear * 


do t 


9.39 “清空 ”按钮 的 单 击 事件 


最 后 一 个 模块 是 屏幕 页 的 错误 事件 (Screen1. ErrorOccurred) 模 块 ,如 图 9. 40 所 示 ， 
在 这 个 事件 中 将 捕获 的 异常 和 错误 显示 在 “消息 记录 ” 栏 中 。 


LUGI Screen! * PETSA 


AA errorNumber + 


[434 functionName + 


get 


图 9.40 屏幕 页 的 错误 事件 


Bluetooth 示例 的 全 部 逻辑 模块 如 图 9. 41 所 示 。 
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图 9.41 Bluetooth 示例 的 全 部 逻辑 模块 
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9.3.1 位 置 传感器 


位 置 服务 (Location-Based Services,LBS) 又 称 定位 服务 或 基于 位 置 的 服务 ,融合 了 
GPS 定位 、 移 动 通信 、 导 航 等 多 种 技术 ,提供 与 空间 位 置 相关 的 综合 应 用 服务 。 定 位 服务 


可 以 获取 用 户 终端 的 位 置信 息 ,Android 系统 支持 GPS、WiFi 和 基站 信号 3 种 定位 方式 。 
位 置 传感器 (LocationSensor) 采 用 上 述 3 种 定位 技 
术 , 可 以 获取 手机 的 经 度 、 纬 度 和 海拔 等 数据 。 位 置 传 感 


器 是 非 可 视 化 控件 ,如 图 9. 42 所 示 。 


位 置 传感器 支持 较 多 属性 ,包括 定位 精度 、 定 位 硬件 、 


经 纬度 ,海拔 等 信息 ,如 表 9.5 所 示 。 
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Non-visible components 


e 


LocationSensorl ' 


图 9.42 位 置 传感器 


Xs 位置 传感器 的 属性 及 说 明 | 


属 性 说 明 ' 
Neat 设备 的 精确 度 ,单位 为 米 | 
AvailableProviders 可 用 的 位 置 服务 提供 硬件 
CurrentAddress 当前 所 在 位 置地 址 
Enabled 是 否 启 用 位 置 服务 
HasAccuracy 是 否 可 返回 设备 精确 度 
HasAltitude 是 否 可 返回 设备 高 度 
HasLongitudeLatitude 是 否 可 返回 设备 经 纬度 
Latitude 纬度 
Longitude 经 度 
Altitude 海拔 高 度 
ProviderLocked 锁定 位 置 服务 提供 者 
ProviderName 位 置 服务 提供 者 名 称 


TimeInterval 


每 隔 多 长 时 间 显示 一 次 定位 信息 


DistanceInterval 


每 隔 多 远 距离 显示 一 次 定位 信息 


位 置 传 感 器 支持 位 置 改变 事件 (LocationChanged) 和 位 置 服务 提供 者 状态 改变 事件 
(StatusChanged) ,如 图 9.43 所 示 。 位 置 改变 事件 在 手机 的 经 度 、 纬 度 和 高 度 发 生变 化 时 
产生 ,一 般 用 来 获取 这 三 项 数值 。 位 置 服务 提供 者 状态 改变 事件 在 位 置 服务 提供 者 的 状 
态 发 生变 化 时 产生 ,用 来 获取 位 置 服务 提供 者 的 基本 信息 和 状态 信息 。 


EIE LocationSensorl "Aia ty ET 


EE LocationSensorl "BESTES 


图 9.43 ”位置 传感器 支持 的 事件 


位 置 传感器 支持 LatitudeFromAddress 方法 和 LongitudeFromAddress 方法 。 
LatitudeFromAddress 方法 可 以 从 地 址 中 获取 经 度 信息 ,LongitudeFromAddress 方法 可 
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以 从 地 址 中 获取 纬度 信息 ,如 图 9.44 所 示 。 

为 了 能 更 好 地 理解 位 置 传感器 的 事件 和 属性 ,下 面 通过 LocationSensor 示例 介绍 如 
何 获取 位 置信 息 和 服务 提供 者 信息 。LocationSensor 示例 可 以 获取 到 手机 的 经 度 、 纬 度 、 
海拔 信息 、 服 务 提供 者 和 状态 信息 .如 图 9. 45 所 示 。 


LocationSensor 


位 置 传感器 输出 信息 
位 置 改变 事件 信息 : 
纬度 : 45.75247 
经 度 : 126.70539 
海拔 : 125.19377 


位 置 服务 提供 者 状态 改变 事件 信息 : 
call .LongitudeFromAddress 服务 提供 者 : gps 


(SY LocationSensorl EMA D aue GG ES 


locationName 


状态 TEMPORARILY UNAV, 
图 9.44 位 置 传感器 支持 的 方法 图 9. 45  LocationSensor 示例 的 运行 界面 


在 界面 编辑 器 中 ,LocationSensor 示例 中 可 视 化 控件 只 有 标签 , 非 可 视 化 控件 有 表格 
布局 和 位 置 传感器 ,如 图 9. 46 所 示 。 


Viewer Components 
Display hidden components in Viewer © screen 
L IAjLabert 
LocationSensor [A]LabelLocationChanged 
位 置 传感器 输出 信息 9 BBrableAmangement1 
[A] i 
位 置 改变 事件 信息 : |A|LabelLatitude 


|A|LatitudeValue 
lA] LabeiLongitude 


I^lLongitudeValue 


位 置 服务 提供 者 状态 改变 事件 信息 : [AjLabelAtitude 


[AJAtitudeValue 
服务 提供 者 。 未 知 图 Labelstatuschanged 
Fre lA] LabelStatusChange. 
状态 : 未 知 ü s 
日 BBrableAmangement2 


[AJLabelProvider 
[AJprovidervalue 
[AjLabelStatus 
M Statusvalue 


® LocationSensorl 


Rename Delete 


Non-visible components 
v Media 
LocationSensorl 
Upload File 


图 9. 46 LocationSensor 示例 界面 设计 图 


LocationSensor 示例 的 逻辑 模块 比较 简单 ,只 有 两 个 关于 位 置 传感器 控件 的 事件 模 
块 ,LocationSensor 示例 的 全 部 逻辑 模块 如 图 9. 47 所 示 。 


Ma Locationsensorl + BP rase curd 


9.3.2 
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when StatusChanged 


图 9.47 LocationSensor 示例 的 全 部 逻辑 模块 | 


谷歌 地 图 


谷歌 地 图 是 谷歌 公司 提供 的 电子 地 图 服务 ,可 以 提供 含有 政 区 交通 和 商业 信息 的 地 
图 ,提供 不 同 分 辩 率 的 卫星 照片 ,并 且 可 显示 地 形 和 等 高 线 地 形 视 图 。 图 9. 48 所 示 是 
Android 手机 中 的 谷歌 地 图 。 
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图 9.48 Android 手机 中 的 谷歌 地 图 


在 AI2 中 使 用 谷歌 地 图 一 般 有 两 种 途径 ,一 种 是 使 用 网 页 浏览 器 (WebViewer) , 93 
一 种 是 使 用 程序 启动 器 (ActivityStarter) 。 

使 用 WebViewer 是 在 浏览 器 中 打开 谷歌 地 图 ,只 需 将 URL 链接 地 址 传递 给 
WebViewer 控件 的 GoToUrl 方法 ,就 可 以 在 Web 浏览 器 中 打开 谷歌 地 图 。 例 如 ,要 获 
取经 纬度 为 (45. 76,126. 70) 的 谷歌 地 图 ,GoToUrl 方法 的 参数 构成 为 “http://maps. 
google. com/maps? q=45.76.126.70”,WebViewer 中 的 显示 效果 如 图 9.49 所 示 。 这 种 
方法 虽然 简单 易 用 ,但 其 显示 速度 和 效果 并 不 十 分 理想 。 
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使 用 ActivityStarter 可 以 在 新 的 屏幕 页 中 打开 谷歌 地 图 ,只 需 将 URI 参数 传递 给 
ActivityStarter 控件 的 DataUri 方法 ,就 可 以 在 新 的 屏幕 页 中 打开 谷歌 地 图 。 这 种 方法 
的 地 图 显示 速度 和 效果 较 好 ,但 用 户 需 要 在 手机 里 面 提前 预 装 谷歌 地 图 应 用 ,如 图 9. 50 
所 示 。 谷 歌 地 图 应 用 的 下 载 地 址 为 https://play. google. com/store/apps/details? id= 


com. google. android. apps. maps。 


45.74201,126| (@ 
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图 9.49 手机 浏览 器 的 谷歌 地 图 图 9.50 谷歌 地 图 


9.3.3 程序 启动 器 


程序 启动 器 (ActivityStarter) 是 启动 其 他 应 用 程序 的 控件 ,可 以 用 来 启动 其 他 AI2 
程序 .摄像 头 程序 .Web 搜索 程序 或 谷歌 地 图 。 程 序 启动 器 是 非 可 视 化 控件 ,如 图 9. 51 
所 示 。 

程序 启动 器 只 有 一 个 AfterActivity 事件 ,如 图 9. 52 所 示 。 打 开 屏 幕 页 (Activity) 后 
产生 该 事件 ,其 参数 result 常用 于 获取 屏幕 页 的 传递 值 。 


st ActivityStarterl WENA awka EAA 


Non-visible components 


多 


ActivityStarter1 
图 9.51 程序 启动 器 图 9. 52 AfterActivity 事件 
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ActivityStarter 支持 StartActivity 和 ResolveActivity 方法 ,如 图 9. 53 所 示 。StartActivity 
方法 用 来 启动 目标 屏幕 页 ,在 相关 参数 设置 完毕 后 ,调用 该 方法 可 以 在 手机 上 直接 打开 新 
的 应 用 程序 。ResolveActivity 用 来 获取 屏幕 页 的 解析 结果 ,如 果 没有 明确 指定 需要 打开 
哪个 应 用 程序 , 则 需要 由 Android 系统 来 确定 ,这 个 方法 可 以 在 正式 打开 程序 前 ,尝试 获 
取 Android 系统 的 解析 结果 。 如 果 ResolveActivity 方法 的 解析 结果 为 空 , 则 表示 没有 可 
以 被 打开 的 应 用 程序 。 


.ResolveActivity 


.StartActivity 


图 9.53 ActivityStarter 的 方法 


通过 设置 ActivityStarter 的 属性 ,可 以 启动 不 同 的 应 用 程序 ,每 项 属性 的 含义 如 


表 9.6 所 示 。 
39.6 ActivityStarter 属性 及 说 明 
属 人 性 说 — HJ 属 人 性 说 HJ 
Action 动作 ExtraValue 键 值 
ActivityClass 类 名 Result 结果 返回 值 
ActivityPackage 包 名 称 ResultName | 结果 返回 值 名 称 
DataUri 通用 资源 符 ResultType 结果 返回 值 类 型 
DataType 数据 类 型 ResultUri 返回 值 的 通用 资源 标识 或 数据 
ExtraKey 键 名 


下 面 将 启动 的 应 用 程序 分 为 5 类 ,介绍 如 何 设 置 程序 启动 器 的 属性 值 ,进而 启动 不 同 
类 型 的 应 用 程序 。 


1. 启动 其 他 ADD 应 用 程序 


启动 其 他 AI2 应 用 程序 只 需要 设置 两 个 参数 , 即 ActivityPackage 和 ActivityClass， 
但 要 找到 这 两 个 参数 值 , 还 是 颇 费 周折 的 。 

首先 要 从 AI2 中 下 载 目标 程序 的 源 代码 ,需要 的 两 个 参数 值 就 在 程序 的 源 代码 中 。 
源 代码 文件 的 扩展 名 是 aia, 可 以 视 其 为 压缩 包 文件 ,使 用 通用 的 压缩 软件 (例如 “360 JE 
缩 ” 软 件 ) 将 其 解压 缩 。 然 后 找到 youngandroidproject/project. properties 文件 ,这 个 文件 
是 保存 应 用 程序 基础 数据 的 文件 ,打开 这 个 文件 ,以 “main” 开 头 的 第 一 行 就 是 需要 的 
内 容 。 

为 了 说 明 如 何 获 取 ActivityPackage 和 ActivityClass 参数 ,下 面 以 LocationSensor 
示例 的 project. properties 文件 内 容 进行 说 明 。 
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main-appinventor.ai warnersuper.LocationSensor.Screen1 
name- LocationSensor 

assets- ./assets 

Source- ./src 

build- ./build 

versioncode- 1 

versionname- 1.0 


useslocation- False 


文件 的 第 一 行 是 以 “main” 开 始 的 ,去 掉 “main 二 ”就 是 ActivityClass 参数 ,也 就 是 说 
ActivityClass 参数 的 值 应 该 是 appinventor. ai_ warnersuper. LocationSensor. Screenl 。 
将 ActivityClass 参数 的 最 后 一 部 分 (. Screen1) 去 掉 , 就 是 需要 的 ActivityPackage 参数 ， 
因此 ActivityPackage 参数 为 appinventor. ai_warnersuper. LocationSensor。 


2. 启动 手机 中 已 有 的 应 用 程序 


启动 手机 中 已 有 的 应 用 程序 需要 设置 Action、ActivityPackage 和 ActivityClass 3 个 
参数 。 下 面 以 摄像 头 程序 为 例 , 说 明 如 何 启动 手机 中 已 有 的 应 用 程序 。 

摄像 头 程序 是 手机 中 必 备 的 内 置 软 件 ,用 来 控制 手机 摄像 头 进行 录像 和 拍照 。 如 果 
要 找到 需要 的 参数 , 则 需 对 基于 代码 的 Android 程序 具有 一 定 的 了 解 ,这 方面 的 内 容 可 以 
参考 笔者 的 另 一 本 Android 书籍 (Android 应 用 程序 开发 (第 2 版 )》。 这 里 将 直接 给 出 需 
要 的 参数 ,如 表 9.7 所 示 。 


表 9.7 启动 手机 程序 的 参数 值 
参数 值 参数 值 


Action android. intent. action. MAIN ActivityClass com. android. camera. Camera 


ActivityPackage | com. google. android. camera 


3. 启动 Web 搜索 程序 


这 里 假设 需要 搜索 的 内 容 是 greatwall, 则 需要 设置 的 参数 共 五 个 ,分 别 是 Action, 
ExtraKey、ExtraValue、ActivityPackage 和 ActivityClass, 具 体 参 数 设 置 如 表 9. 8 所 示 。 


表 9.8 启动 Web 搜索 程序 的 参数 值 


参 数 值 
Action android. intent. action. WEB_SEARCH 
ExtraKey query 
ExtraValue greatwall 
ActivityPackage com. google. android. providers. enhancedgooglesearch 
ActivityClass com. google. android. providers. enhancedgooglesearch. Launcher 


第 9 章 网 络 通 信 与 地 图 应 用 


4. 启动 浏览 器 ,并 打开 指定 的 网 页 


启动 手机 中 内 置 的 Web 浏览 器 ,并 打开 指定 链接 地 址 的 网 页 ,需要 设置 参数 Action 
和 DataUri 的 值 。Action 参数 设置 为 android. intent. action. VIEW ,表示 调用 手机 内 部 
程序 浏览 指定 的 内 容 , 但 具体 会 打开 哪个 程序 ,还 是 要 根据 所 指定 的 “浏览 内 容 " 确 定 。 笔 
者 将 第 二 个 参数 DataUri 设置 为 http://android. hrbeu. edu. cn, 其 实 只 要 出 现 “http” 的 
字样 ,Android 系统 就 会 调用 系统 内 部 的 Web 浏览 器 。 启 动 浏览 器 打开 网 页 的 参数 值 如 
表 9.9 所 示 。 


5. 启动 谷歌 地 图 .显示 指定 地 点 


启动 谷歌 地 图 并 显示 指定 地 点 需要 设置 的 参数 依然 为 Action 和 DataUri, DataUri 
的 中 的 参数 为 geo:0.0&.q= Potala Palace, 其 中 ,Potala Palace 是 要 显示 在 地 图 上 的 地 
点 。 启 动 谷歌 地 图 并 显示 指定 地 点 的 参数 值 设 置 如 表 9. 10 所 示 。 


表 9.9 启动 浏览 器 打开 网 页 的 参数 值 表 9.10 启动 谷歌 地 图 的 参数 值 

参数 值 参数 值 
Action android. intent. action. VIEW Action android. intent. action. VIEW 
DataUri http://android. hrbeu. edu. cn DataUri ge0:0,08-q— Potala Palace 


9.3.4 梦幻 旅游 示例 


DreamTour 示例 可 以 浏览 图 片 中 的 四 大 旅游 胜地 ,并 在 谷歌 地 图 中 查看 旅游 胜地 的 
位 置 。DreamTour 示例 的 运行 界面 如 图 9. 54 所 示 。 


DreamTour 


jA 


JARRA. 纽约 自由 女神 像 


图 9.54  DreamTour 示例 的 运行 界面 


界面 中 “选择 景点 "标签 下 方 的 4 个 小 图 片 是 可 以 单 击 的 按钮 , 单 击 不 同 的 小 图 片 会 
显示 不 同 景点 的 名 称 和 图 片 。4 个 小 图 片 分 别 是 复活 节 岛 石像 .拉萨 布 达 拉 宫 、 纽 约 自由 
女神 像 和 巴黎 埃菲尔 铁塔 。 选 择 不 同 的 景点 后 单 击 * 打 开 地 图 "按钮 ,就 可 以 启动 谷歌 地 
图 ,并 自动 搜 所 选择 的 景点 ,然后 将 景点 的 位 置信 息 显示 在 地 图 上 。 
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An [E 9.55 Br zx X DreamTour 示例 界面 设计 图 ,需要 注意 的 是 ,在 设置 
ActivityStarter 的 属性 时 ,Action 属性 是 务必 要 设置 的 ,而 DataUri 是 在 程序 运行 过 程 中 
根据 用 户 选择 进行 动态 设置 的 。ActivityClass 和 ActivityPackage 参数 是 选择 性 设置 的 ， 
设置 这 两 个 参数 ,可 以 唯一 指定 要 启动 的 程序 ;如 果 不 设 置 ,在 手机 中 装 有 多 个 地 图 软件 
时 ,会 要 求 用 户 进 行 选择 ,如 图 9. 56 所 示 。 


Viewer Components 


日 [ screen 


E isplay hidden components in Viewer 


国 ,maoe 
日 国 horzontalAmrangement1 
[A] Labelview 
Al Labelinfo 
日 国 Horizontalarangement2 
Bl sutor 
国 euttonz 
国 euttons 
国 auto4 
国 automap 
# ActivityStarter 


A Notifen 


Rename Delete 


Non-visible components 
多 A 
ActivityStarterl Notifiert 


Upload File 
9.55 DreamTour 示例 界面 设计 图 


如 果 和 希望 避免 从 多 个 地 图 软件 中 选择 ,参照 表 9. 11 设置 ActivityClass 和 ActivityPackage 
参数 ,可 以 直接 打开 谷歌 地 图 。 


完成 动作 的 方式 
表 9.11 启动 谷歌 地 图 的 参数 值 
参数 值 
Action android. intent. action. VIEW 
DataUri geo:0.08.q— Isla de Pascua 
ActivityClass | com. google. android. maps. MapsActivity 
ActivityPackage com. google. android. apps. maps 


图 9.56 选择 动作 方式 


第 9 章 网络 通信 与 地 图 应 用 


在 模块 编辑 器 中 创建 响应 四 个 按钮 的 单 击 事件 ,根据 用 户 单 击 的 按钮 不 同 ,选择 不 同 
的 图 片 在 图 像 Imagel 上 显示 ,并 修改 标签 LabelInfo 的 显示 内 容 属 性 Text, 如 图 9. 57 
所 示 。 ! 


图 9.57 景点 按钮 单 击 事件 


在 单 击 ButtonMap 按钮 后 ,会 调用 Notifierl 控件 的 ShowChooseDialog 方法 ,打开 
选择 对 话 框 。ButtonMap 单 击 事件 模块 如 图 9. 58 所 示 。 


butte 
button2Text 


cancelable 


Æ 9.58 Buttonmap 按钮 单 击 事件 


根据 ShowChooseDialog 方法 的 参数 设 定 ， 
选择 对 话 框 的 内 容 如 图 9. 59 所 示 。 询问 
用 户 在 选择 对 话 框 中 做 出 抉择 后 ,会 触发 
Notifierl 控件 的 AfterChoosing 事件 ,根据 参数 


choice 的 值 判断 用 户 的 选择 。 因 为 用 户 可 以 选择 是 5 
的 值 具 有 * 是 "和 * 和 否 ”, 因 此 只 要 判断 choice 的 值 
是 否 为 “是 ”。 如 果 是 , 则 设置 ActivityStarterl 的 图 9.59 ”选择 对 话 框 


DataUri 属性 ,然后 调用 StartActivity 方法 打开 
谷歌 地 图 ,如 图 9. 60 所 示 。 


确认 打开 谷歌 地 图 ? 


shen uri . AfterChoosing 


EED ED 


图 9. 60  AfterChoosing 事件 


DreamTour 示例 的 全 部 逻辑 模块 如 图 9. 61 所 示 。 
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Em vorifierl MX a 


MU Button] - Boir 
do set 


when «Click 
do set 


9.61 DreamTour 示例 的 全 部 逻辑 模块 


CASE 


1. 使 用 Web 控件 获取 天 气 预 报信 息 ,并 将 获取 到 的 数据 显示 在 用 户 界面 上 。 

2. 使 用 蓝牙 控件 开发 一 款 数据 库 备份 软件 ,可 以 将 本 地 数据 库 的 数据 通过 蓝牙 传输 
到 另 一 个 手机 设备 上 进行 备份 ,并 能 够 利用 备份 恢复 数据 。 

3. 编程 实现 轨迹 追踪 软件 。 每 间隔 60 秒 ,同时 距离 移动 大 于 1 米 的 情况 下 ,记录 一 
次 位 置信 息 , 在 数据 库 中 记录 600 秒 的 行动 轨迹 ,并 可 以 尝试 在 谷歌 地 图 上 显示 行动 
轨迹 。 


内 置 模 块 (Build-In) 中 包含 控制 (Control)、 逻 辑 (Logic) 、 数 学 (Math) ,文本 (Text)、 
列表 (Lists) ,颜色 (Colors) , Æ flit (Variables) 和 函数 (Procedures) 共 8 个 模块 集 , 每 个 模 


Y 


块 集 的 使 用 说 明 如 表 A. 1— & A. 8 BER. 


表 A.1 控制 模块 集 使 用 说 明 


名 fk 模块 图 示 说 — 明 
判断 语句 , 若 if 的 条 件 
为 true, 则 执行 then 区 
让 …then 域 的 语句 ,否则 跳 过 此 


段 。 通 过 蓝 色 图 标 可 以 
添加 else 的 选项 


for each 


循环 语句 , 取 介 于 from 
到 to 之 间 、 间 隔 为 by 
的 每 一 数值 执行 一 次 
do 区 域 的 语句 


for each in list 


循环 遍历 列表 ,对 于 列 
R list 中 的 每 一 个 值 执 
行 do 区 域 的 语句 


while 


循环 语句 , 当 测试 条 件 
test 为 true 时 ,执行 do 
区 域 的 语句 , test 为 
false 时 退出 循环 


if then else 


判断 语句 , 若 if 区域 的 
条 件 为 true, 则 返回 
then 区 域 语句 的 结果 
值 ,否则 返回 else 区 域 
语句 的 结果 值 


do 


zz 
o 
= 
E 
B 
= 


执行 do 区 域 的 语句 并 
返回 result 的 值 


7 


7 


Z 
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续 表 
名 称 模块 图 示 说 — B 
— evaluate but ignore result lp 
open another iT F screenName 2 数 


open another screen screenName 


指定 的 屏幕 页 

打开 screenName 参数 

open another screen with start value screenName 指定 的 屏幕 页 ,并 向 其 
startValue 传递 由 startValue 指定 

的 参数 


- 传递 的 值 
close screen 关闭 当前 屏幕 页 


关闭 当前 屏幕 页 ,并 返 
回 result 指定 的 值 


application 


Screen 


open another 
screen with 


start value 


close screen ; 
close screen with value result 


with value 


get plain start RE IEn GERNE NUN 返回 当前 屏幕 页 启动 时 
text —— - ~ 传递 的 文本 值 
close screen OT EET 关闭 当前 屏幕 页 ,并 返 
with plain text SL ES E text 文本 值 


表 A.2 逻辑 模块 集 使 用 说 明 
名 称 模块 图 示 说 “H 


ue 布尔 值 为 丰 
布尔 值 为 假 
um 取 反 运 算 


通过 下 拉 列 表 选 择 判 断 的 方式 ,判断 两 个 参数 是 


=. 否 相等 (或 不 相等 ) ,参数 可 以 是 数字 、 字 符 串 或 
列表 
- 逻辑 与 运算 , 若 测试 条 件 有 一 个 为 假 , 则 运算 结果 


为 假 (false) ,否则 为 真 (true) 


逻辑 或 运算 , 若 测试 条 件 有 一 个 为 真 , 则 运算 结果 
为 真 (true) ,否则 为 假 (false) 


or 


表 A.3 数学 模块 集 使 用 说 明 


BRA 内置 模块 


模块 图 示 


说 明 


定义 一 个 数值 型 常量 


根据 判断 结果 返回 true 或 
false, 支持 的 判断 有 等 于 
(一 )\ 不 等 于 (天 )、 小 于 等 于 
(<<)、 大 于 等 于 (之 )、 小 于 
(二 ) 及 大 于 (二 ) 


对 两 数值 进行 加 法 运算 ,并 
返回 结果 , 蓝 色 图 标 可 以 修 
改 参与 加 法 运算 的 值 的 个 数 


对 两 数值 进行 减法 运算 ,并 
返回 结果 


对 两 数值 进行 乘法 运算 ,并 
返回 结果 


对 两 数值 进行 除法 运算 ,并 
返回 结果 


若 第 二 个 参数 的 值 是 n, E 
回 第 一 个 参数 的 n 次 方 


random integer 


返回 一 个 指定 范围 的 随机 整 
数 ,通过 from 和 to 设置 随 
机 数 的 取 值 范围 


random fraction 


返回 一 个 0 一 1 之 间 的 随机 
小 数 


random set seed 指定 随机 数 生 成 器 的 种 子 
min, max 返回 最 小 值 (或 最 大 值 ), 蓝 
色 图 标 可 以 修改 参数 的 个 数 


sqrt, abs, — , log, 
e^, round, ceiling, 
floor 


round 
ceiling 
floor 


数学 运算 ,支持 平方 根 
(sqrt)、 绝 对 值 (abs)、 取 反 
(一 )、 对 数 (log)、e 的 次 方 
Ce) UE EAM (round), 
向 上 取 整 (ceiling) 及 向 下 取 
整 (floor) 
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说 9 


modulo, remainder, 
quotient 


4 modulo 
remainder 
quotient 


除法 和 取 余 , 支 持 quotient 
(返回 除法 商 的 整数 部 分 )、 
module( 返 回 除法 结果 的 余 
数 ,结果 与 第 二 个 数字 同 
Æ) ,remainder( 返 回 除法 结 
果 的 余数 ,返回 结果 与 第 一 
个 数字 同 号 ) 


sin, cos, tan, asin, 
acos,atan 


v sin 
cos 
tan 


asin 


acos 
atan 


三 角 函 数 ,支持 正弦 (sin)、 
余弦 (cos) , IE Y) (tan) ,反正 
3k Casin) t LR 9E (scos) 


atan2 


计算 y/z 的 反正 切 值 


convert 


convert 


ns to degrees 
degrees to radians 


弧度 和 弦 转 换 函 数 ,支持 弧 
度 转化 为 角度 (radians to 
degrees) 和 角度 转换 为 弦 度 


(degrees to radias) 


format as decimal 


format as decimal 
number 


places 


将 数字 (number) 转 化 为 有 指 
定 小 数 (places) 位 的 值 , 若 小 
数 过 多 则 采用 四 会 五 入 的 方 
法 ,不 够 则 补 0, places 的 值 
必须 为 正 数 


is a number? 


is a number? 


判断 是 否 为 数值 ,若是 则 返 
El true, 和 否则 返回 false 


表 A.4 Text 模块 集 使 用 说 明 


名 # 模块 图 示 说 上 明 
text string ET 定义 字符 串 常量 

Fa B 将 指定 的 多 个 字符 串 连接 成 一 个 新 的 字符 串 ， 
: 单 击 蓝 色 的 图 标 可 以 添加 字符 串 的 个 数 
length mm 返回 指定 字符 串 的 长 度 , 包 括 空格 符 的 个 数 

is empty ET 车 字符 串 的 长 度 为 0 返回 true, 和 否则 返回 false 


BA 内置 模块 


模块 图 示 


compare texts 


compare texts C| 


字符 串 比 较 ,支持 第 一 个 字符 串 是 否 小 于 第 二 
个 字符 串 〈 雪 ) 、 两 个 字符 串 是 否 相等 (二)、 第 
一 个 字符 串 是 否 大 于 第 二 个 字符 串 (>) 


trim Er 删除 指定 字符 串 首位 的 空格 
" Mass *T. 大 小 写 转换 ,支持 将 字符 串 中 的 所 有 字母 转换 
Pa pik 4 upcase 为 大 写字 母 (upcase) ,将 字符 串 中 的 所 有 字母 
downcase 转换 为 小 写字 母 (downcase) 
获取 字符 串 piece 在 字符 串 text 中 的 位 置 , 若 
— eg 成 功 匹 配 则 返回 piece 字符 串 的 首 字母 在 text 
中 的 位 置 ,如 果 未 找到 piece 则 返回 0 
Y 若 字符 串 text 中 包含 字符 串 piece, 则 返回 
A true, FWE E] false 
4 split at first 
split split at first of any 拆 分 字符 串 ,支持 多 种 拆 分 字符 串 的 方法 
split 
split at any 
split at spaces 利用 空格 拆 分 字符 串 


segment 


从 字符 串 text 的 开始 点 start 开始 截取 长 度 为 
length 的 字符 串 


replace all 


将 字符 串 text 中 的 字符 串 segment 替换 为 字 
符 串 replacement 


RAS 列表 模块 集 使 用 说 明 


名 称 模块 图 示 说 — 8 
—— E = TERTEER 新 建 一 个 空 列表 , 当 单 击 蓝 色 图 标 加 入 
create empty lis: create empty lis 一 个 列表 项 时 成 为 make a list 


make a list 


make a list 


新 建 一 个 列表 , 单 击 蓝 色 的 图 标 可 以 添 
加 列表 项 的 个 数 


add items to list 


add items to list list 


item 


在 列表 的 末尾 插入 指定 的 列表 项 


可 视 化 开发 Android 应 用 程序 


— i | + X HE A App Inventor 2 (第 2 收 ) 


模块 图 示 


说 9 


is in list? 


is in list? thing 


list 


判断 thing 是 否 在 列表 中 ,如 果 在 列表 
中 ,返回 true, 和 否则 返回 false 


length of list 


length of list list 


返回 列表 的 长 度 


is list empty? 


is list empty? list 


判断 列表 是 否 为 空 , 若 为 空 则 返回 true, 
否则 返回 false 


pick a random item 


pick a random item list 


随机 取出 列表 中 的 一 个 列表 项 


index in list thing 


index in list thing 
list 


返回 列表 项 thing 在 列表 中 位 置 索引 值 ， 
若 thing 不 存在 于 列表 中 , 则 返回 0 


select list item 


select list item list 


i 


返回 列表 index 索引 位 置 的 列表 项 


insert list item 


insert list item list 
index 


item 


将 列表 项 item 插入 列表 中 的 index 索引 
位 置 


replace list item 


replace list item list 


index 


replacement 


用 replacement 替换 列表 中 索引 位 置 为 
index 的 列表 项 


remove list item 


remove list item list 


index 


删除 列表 中 索引 index 位 置 的 列表 项 


append to list 


append to list listl 


list2 


将 列表 list2 中 的 列表 项 添加 到 列表 
listl 的 后 面 ,list2 中 的 列表 项 不 变 


"- xai 
b aik ” T n 判断 thing 是 否 为 列表 ,若是 则 返回 
is a list is a list? thing 


true, 和 否则 返回 false 


list to csv row 


list to csv row list 


将 列表 中 的 列表 项 转化 为 CSV 表格 的 
一 行 ,并 将 该 行文 本 返回 ,返回 的 文本 尾 
部 没有 换行 符 


list to csv table 


list to csv table list 


将 列表 中 的 列表 项 以 行 优先 的 方式 填充 
到 CSV 表格 ,并 将 该 表格 的 文本 值 , 表 
格 中 每 行 的 元 素 以 逗号 隔 开 ,换行 时 以 
"Nn" BE 


续 表 
名 称 模块 图 示 说 明 
n = T EDU 将 csv 表 格 中 的 一 行 转 化 为 一 个 列表 
ist from csv row list from csv row text >= 
返回 
将 csv 表格 中 的 内 容 以 行 优先 的 次 序 转 
list from csv table list from csv table text 换 为 列表 返回 ,以 \n 或 CRFT(\r\n) 区 


分 不 同 的 行 


lookup in pairs 


lookup in pair 


notFound 


返回 列表 pairs 中 与 关键 字 key 相关 联 
的 值 , 若 未 找到 则 返回 notFound 的 值 


表 A.6 颜色 模块 集 使 用 说 明 


名 称 模块 图 示 说 明 
color 提供 了 13 种 基本 的 颜色 模块 
自 定义 颜色 ,由 3 个 或 4 个 参数 组 成 ， 
make color make a list 前 三 个 参数 代表 RGB 三 原色 的 强度 ， 
PEN 第 一 个 参数 代表 红色 (R) ,第 二 个 参 
数 代表 绿 色 (G) ,第 三 个 参数 代表 蓝 
色 (B), 若 有 第 四 个 参数 则 代表 alpha 
值 或 者 颜色 的 透明 度 
solvadi 将 颜色 color 分 解 为 创建 该 颜色 的 
split color split color RGB 值 
表 A.7 变量 模块 集 使 用 说 明 
名 称 模块 图 示 说 明 
initialize global initialize global 定义 全 局 变量 ,name 为 变量 名 
get get ob 获取 全 局 变量 name 的 值 
set CE global name * RZ2 设置 全 局 变量 name 的 值 


initialize local 


定义 局 部 变量 ,name 为 变量 名 , 单 击 
蓝 色 图 标 可 以 增加 局 部 变量 的 数量 
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RAS 函数 模块 集 使 用 说 明 


模块 图 示 说 明 


procedure 


创建 无 返回 值 的 函数 , 单 击 蓝 色 图 标 可 以 
添加 参数 的 个 数 


call 


procedure result 


创建 具有 返回 值 的 函数 


Ce 调用 无 返回 值 的 函数 


call 


调用 具有 返回 值 的 函数 
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控件 库 (Palette) 中 包含 常用 控件 (User Interface). BÉ $E tp Jj (Layout) , W fk 
(Media), Z} I| ( Drawing and Animation), f£ J& #& (Sensors), #Ë 3€ (Social), ff fif 
(Storage) Jill fë (Connectivity) 和 乐高 机 器 人 (LEGO MINIDSTORMS) 9 个 子 类 , 共 51 
个 控件 ,每 个 控件 拥有 多 个 事件 .方法 和 属性 。 


B1 常用 控件 


常用 控件 子 类 共有 11 个 控件 ,包括 按钮 (Button) 、 复 选 框 (Checkbox) \、 时 钟 (Clock) 、 
图 像 (Image)、 标 签 (Label)、 选 项 列表 (ListPicker)、 通 知 控件 (Notifier)、 密 码 框 
(PasswordTextBox) ,滑动 条 (Slider) .文本 框 (TextBox) 和 网 页 浏览 器 (WebViewer) ,各 
控件 的 事件 ,属性 和 方法 如 表 B. 1 一 表 B. 11 所 示 。 


1. 按钮 
按钮 是 最 基本 的 控件 ,主要 提供 单 击 式 的 触发 操作 ,实现 基本 的 人 机 交互 功能 。 
表 B.1 按钮 控件 的 模块 说 明 
模块 名 称 # A 模块 说 明 
Button( 实 例 ) 按钮 实例 


Click( 事 件 ) 单 击 事件 


SEE 
LongClick( 事 件 ) g 长 单 击 事件 


GotFocus( 事 件 ) 获取 焦点 事件 


LostFocus( 事 件 ) 失去 焦点 事件 
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# 
模块 名 称 模 K 
J BackgroundColor 
Enabled Enabled 
Heisht Height 
Inoge Trage 
ShowFeedback l ShowFeedback 
Text | Text 
属性 Wess | sein 
Width Width 
读 写 属性 : BackgroundColor( #f 3& € ) , Enabled Cf £l n] JH E) , Height( 控 件 高 
BE) Image H #t [8] Hr) ShowFeedback( 是 否 有 视觉 反馈 )、Text( 显 示 文 本 )、 
TextColor( 文 本 颜色 )、Visible( 可 见 性 ) 及 Width( 控 件 宽度 ) 
2. 复 选 杠 
复 选 框 是 可 以 同时 选中 多 项 的 选项 框 ,供用 户 进行 多 项 选择 时 使 用 ,在 程序 中 起 到 条 
件 识 别 的 作用 。 
表 B.2 复 选 框 控件 的 模块 说 明 
模块 名 称 BOX 模块 说 明 
CheckBox( 实 例 ) [CheckBoxl `] 复 选 框 的 一 个 实例 
adeo NEST 1 i ; 
Changed( 事 件 ) " COTE 复 选 框 状态 改变 事件 (选中 或 者 取消 
选中 ) 
CheckBEoxl * MICI 
GotFocus( 事 件 ) 获取 焦点 事件 
LostFocus( 事 件 ) Ta 失去 焦点 事件 
V BackgroundColor BackgroundColor 
Checked 
Enabled 
n FontSize 
Ca T 
属性 Ter TextColor 
width Visible 
Width 
读 写 属性 : BackgroundColor 3$ X f ) , Checked (是否 选 中 )、Enabled( 复 选 框 
可 用 性 )、Height (控件 高 度 )、FontSize (字体 大 小 )、Text (显示 文本 )、 
TextColor( 文 本 颜色 ) 、Visible( 控 件 可 见 性 ) 及 Width( 控 件 宽度 ) 
3. 时 钟 


时 钟 是 非 可 视 化 组 件 , 可 以 获取 当前 时 间 、 格 式 化 输出 时 间 、 对 时 间 进 行 运算 ,还 可 以 


在 固定 的 时 间 间 隔 触 发 事件 。 


表 B.3 时钟 控件 的 模块 说 明 
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模块 名 称 模 k 模块 说 明 
Clock( 实 例 ) 时 钟 实例 
when Timer 
Timer( 事 件 ) u 触发 事件 
SystemTime( 方 法 ) 手机 的 内 部 系统 时 间 , 单 位 为 毫秒 
Now( 方 法 ) 从 手机 时 钟 读 取 当 前 时 间 
i i E 干 秒 以 后 
AddSeconds( 方 法 ) uid "uie TNT id 
i ins E 以 后 
AddMinutes( 方 法 ) er 上 
计算 ins \ 时 以 后 
AddHours( 方 法 ) ia Be 增加 若干 小 时 以 后 的 
计算 ins 以 后 的 四 
AddDays( 方 法 ) id instant 增加 若干 天 以 后 的 时 
i ins a] h 
Add Weeks ITO id instant 增加 若干 周 以 后 的 时 
计算 instal 以 后 的 时 
AddMonths( 方 法 ) instant 增加 若干 月 以 后 的 时 
计算 ins " " 
AddYears( 方 法 ) pia 增加 计算 若干 年 以 后 
DayOfMonth( 方 法 ) T wass s 人 
计算 两 个 时 间 点 start 和 end 的 时 
Duration( 方 法 ) 间 间 隔 , 单 位 为 毫秒 
FormatDate( 方 法 ) 格式 化 输出 instant 时 间 点 的 日 期 
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续 表 
模块 名 称 模 块 模块 说 明 
FormatDateTime( 方 法 ) WE To Daterin 格式 化 输出 instant 时 间 点 的 日 期 
stant 和 时 间 
FormatTime( 方 法 ) 1 CH ro RE 格式 化 输出 instant 时 间 点 的 时 间 
NN EUN .cetillis 从 1970 年 1 月 1 日 开始 累计 到 现 
GetMillis( 方 法 ) 在 的 时 间 , 单 位 为 毫秒 
Hour( 方 法 ) spo pus 获取 instant 时 间 点 的 小 时 数 
利用 “月 /日 /年 时 :分 : 秒 "“ 月 / 
MakeInstant( 方 法 ) 日 /年 "“ 时 :分 ”的 格式 定义 时 


间 点 


MakelnstantFromMillis 


(方法 ) 


通过 毫秒 数 定义 时 间 点 


Second( 方 法 ) 获取 instant 时 间 点 的 秒 数 
Minute( 方 法 ) 获取 instant 时 间 点 的 分 钟 数 
获取 instant 时 间 点 是 周 几 , 为 1 
Weekday Opa) ( 周 日 ) 到 7( 周 六 ) 之 间 的 数字 
WeekdayName( 方 法 ) 获取 instant 时 间 点 是 周 几 
获取 instant 时 间 点 的 月 份 数 ,为 
MENEGI 1~12 之 间 的 数字 
MonthName( 方 法 ) 时 间 点 的 月 份 ,用 名 
Year( 方 法 ) 获取 instant 时 间 点 的 年 份 
TimerAlwaysFires 
属性 TimerInterval vV TimerInterval 
读 写 属性 : TimerAlwaysFires( 是 否 允许 多 次 触发 )、TimerInterval( 定 时 器 
的 时 间 间 隔 ,单位 是 毫秒 ) .TimerEnabled( 时 钟 是 否 可 用 ) 
4. 图 像 


图 像 控 件 用 于 在 界面 上 显示 各 种 图 像 文件 ,不 支持 事件 。 
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模块 名 称 & K 模块 说 明 
Image( 实 例 ) 图 像 实例 
V Animation 
Height 
Picture 
Visible 
属性 Width 
读 写 属性 : Animation( 动 态 图 片 ).Picture( 图 片 背景 )、Visible( 控 件 可 见 性 )、 
Width( 控 件 的 宽度 ) 、Height( 控 件 的 高 度 ) 
只 写 属性 : Animation( 设 置 控件 的 动态 图 片 ) 
5. 标签 
标签 主要 起 到 文字 显示 的 作用 ,但 标签 不 允许 用 户 进 行 输 入 操作 ,只 能 够 显示 文字 
信息 。 
表 B.5 标签 控件 的 模块 说 明 
模块 名 称 BOX 模块 说 明 
Label( 实 例 ) 标签 实例 
V BackgroundColor V em 
FontSize FontSize 
Height Height 
Text Text 
TextColor TextColor 
属性 Visible Visible 
Width Width 
读 写 属性 : BackgroundColor (2$ X &) , Height (4% f/F Pi HE) , FontSize F f X 
小 )、Text( 显 示 文 本 )、TextColor( 文 本 颜色 )、Visible( 控 件 可 见 性 ) 及 Width 
(控件 宽度 ) 
6. 选项 列表 


选项 列表 是 从 多 个 选项 中 选取 某 一 个 选项 的 控件 ,适合 多 选 一 的 情况 。 
表 B.6 选项 列表 控件 的 模块 说 明 


模块 名 称 模 块 模块 说 明 
ListPicker( 实 例 ) ListPickerl " 选项 列表 实例 
LIE ListPickerl * awaa str ETE Y Y 
Boorebicking GE ÁO " 3 选 前 事件 , 当 点 开 选 项 列表 ,但 没有 选 


择 其 中 某 项 时 产生 
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续 表 
模块 名 称 模块 说 明 
when .AfterPicking 选 后 事件 , 当 点 开 选 项 列表 并 选中 其 
AfterPicking( 事 件 ) 3 x 项 时 产生 
when Wasa 
GotFocus( 事 件 ) 获取 焦点 事件 
mul .LostFocus 
LostFocus( 事 件 ) 失去 焦点 事件 
Open( 方 法 ) 打开 选项 列表 供 选 择 
[Gisticker] * BI BackgroundColor 
V BackgroundColor 
Elements 
ElenentsFromtring Enabled 
Enabled Height 
Height Tmage 
Image Selection 
Seleetion SelectionIndex 
SelectionIndex ShowFeedback 
ShovFeedback ShowPilterBar 
ShowFilterBar Text 
Text TextColor 
ms mitis m 
Visible Width 
Width 
读 写 属性 : BackgroundColor #f $ € ) , Elements Ji] R ji 3 A ) , Enabled (4% fft 
的 可 用 性 )、Height( 控 件 高 度 ) ,Image( 背 景 图片 )、Selection( 选 中 的 列表 项 属 
性 )、SelectionIndex( 用 户 选 中 的 列表 项 序号 ) .ShowfeedBack( 是 否 有 视觉 反馈 
信息 )、ShowFilterBar( 是 否 显 示 搜 索 过滤 条 ) , Text CA AE), TextColor XC 
本 颜色 )、Title( 标 题 )、Visible( 控 件 可 见 性 )、Width( 控 件 宽度 ) 
只 读 属 性 : ElementsFromString( 使 用 逗号 分 隔 的 字符 串 导 入 列表 ) 
7. 通知 控件 


通知 控件 用 来 显示 对 话 框 信息 和 浮动 提示 信息 ,并 支持 输出 Android 系统 的 Log 


日 志 。 
表 B.7 通知 控件 的 模块 说 明 
模块 名 称 Hox 模块 说 明 
Notifier( 实 例 ) Moren] 通知 控件 实例 


when AfterChoosing 用 户 在 选择 对 话 框 中 做 出 选择 
触发 该 事件 , choice 是 用 户 单 
击 的 选择 按钮 的 文本 值 


AfterChoosing( 事 件 ) 
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续 表 
模块 名 称 模块 说 明 
when 本 ET | 在 文本 对 话 框 中 输入 文本 值 
后 ,退出 对 话 框 时 触发 该 事件 ， 
人 response 是 用 户 在 文本 对 话 杠 
中 输入 的 文本 值 
LogError( 方 法 ) Log 日 志 的 错误 信息 
LogInfo( 方 法 ) Log 日 志 的 提示 信息 
LogWarning (方法 ) Log 日 志 的 警告 信息 
ShowAlert( 方 法 ) 显示 浮动 信息 
call Notifieri T .s 显示 有 两 个 或 3 个 按钮 的 选择 
对 话 框 ,显示 的 信息 是 
message, 对话 的 标题 为 title, 
2E S 作为 选择 的 两 个 按钮 为 
buttonlText 和 button2Text, 
如 果 cancelable 为 true, 将 会 出 
现 第 三 个 按钮 Cancel 
_ n 显示 信息 对 话 框 ,title 为 对 话 
a 框 的 标题 , buttonText 为 取消 
对 话 框 的 按钮 
显示 文本 对 话 框 , message 是 
ShowTextDialog 对 话 框 的 提示 信息 ,title 为 对 
(方法 ) 话 框 的 标题 ,如 果 cancelable 为 
true, 用 户 可 以 通过 单 击 Cancel 
按钮 选择 取消 
ackg r 
属性 
读 写 属 性 : TextColor( 文 本 颜色 ) 
只 读 属 性 : BackgroundColor( 背 景 颜色 ) 
8. 密码 框 


密码 框 是 一 种 特殊 的 文本 框 , 一 般 用 于 接受 用 户 输入 密码 。 用 户 输入 密码 时 ,密码 框 
会 对 输入 的 内 容 进 行 屏蔽 处 理 。 
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模块 名 称 模块 说 明 
PasswordTextBox 
(实例 ) 密码 框 实例 
cies GotFocus 
GotFocus( 事 件 ) 获取 焦点 事件 
when pum 
LostFocus £ ff) m 失去 焦点 事件 
r= ; — 
V BackgroundColor V BackgroundColor 
Enabled Enabled 
FontSize FontSize 
Height Height 
Hint Hint 
Text Text 
属性 TextColor TextColor 
Visible Visible 
Width Width 
读 写 属性 : BackgroundColor( 控 件 的 背景 色 )、FontSize( 字 体 的 大 小 )、 Height 
Gi fff BE) , Enabled (控件 的 可 用 性 )、Hint( 用 户 提示 信息 )、Text( 文 本 内 
容 ) .TextColor( 文 本 颜色 ) , Visible fF nf IHE) , Width e pF S HE) 
9. 滑动 条 


滑动 条 是 一 种 供用 户 调整 进度 的 控件 ,用 户 可 以 拖 动 调整 拖 动 条 的 位 置 ,可 以 通过 滑 
动 条 调整 改变 字体 的 大 小 或 者 声音 的 大 小 。 


表 B.9 滑动 条 控件 的 模块 说 明 


模块 名 称 BOX 模块 说 明 
Slider( 实 例 ) 滑动 条 实例 
Emu ; .PoeitionoChaneed 
PositionChanged - 
(事件 ) 滑 块 位 置 改变 事件 
V ColorLeft A 
ColorRight ColorRight 
MaxValue MaxValue 
MinValue MinValue 
ThumbPosition ThumbPosition 
属性 Visible Visible 


Width Width 


读 写 属性 : ColorLeft( 滑 动 条 进度 位 置 左边 的 颜色 ) ColorRight( 滑 动 条 进度 
位 置 右边 的 颜色 )、MaxValue( 滑 动 条 最 大 值 ).MinValue( 滑 动 条 最 小 值 )、 
ThumbPosition( 滑 块 的 当前 位 置 ,) .Visible( 控 件 可 见 性 ) 、Width( 控 件 宽度 ) 


10. 文本 框 
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文本 框 是 一 种 供用 户 输入 文字 的 容器 。 虽 然 文本 框 可 以 显示 文字 信息 ,但 其 主要 功 
能 还 是 为 用 户 提供 输入 信息 的 区 域 ,比如 登录 框 、 搜 索 栏 或 编辑 文字 的 写字 板 等 。 


表 B.10 文本 框 控件 的 模块 说 明 


模块 名 称 BOX 模块 说 明 
TextBox( 实 例 ) 文本 框 实例 
GotFocus( 事 件 ) 获取 焦点 事件 
LostFocus( 事 件 ) cr 一 一 失去 焦点 事件 
HideKeyboard( 方 法 ) T HideK 隐藏 软 键盘 
TextBoxl ' BackgroundColor " 
V BackgroundColor V BackgroundColor 
Enabled Enabled 
FontSize FontSize 
Height Height 
Hint Hint 
MultiLine MultiLine 
NuzbersOnly NumbersOnlv 
Text Text 
TextColor TextColor 
nu ium nd 
读 写 属性 : BackgroundColor( 控 件 的 背景 色 )、FontSize( 文 本 框 字体 的 大 小 )、 
Height( 控 件 高 度 ) .Enabled( 控 件 的 可 用 性 )、Hint( 用 户 提 示 信 息 )、MultiLine 
(如 果 MultiLine 设置 为 true, 允许 用 户 输入 多 行 的 信息 ,此 时 需要 调用 
HideKeyboard 方法 隐藏 软 键盘 )、NumbersOnly( 如 果 设 置 为 true, 只 允许 用 户 
输入 数字 ) ,Text( 文 本 内 容 )、TextColor( 文 本 颜色 )、Visible( 控 件 可 见 性 ) 及 
Width( 控 件 宽度 ) 


11. 网 页 浏览 器 


网 页 浏览 器 是 用 来 显示 网 页 的 控件 ,使 用 者 可 以 设置 主页 (HomeUrl) ,也 可 以 打开 
某 个 指定 的 页 面 ,并 支持 在 浏览 记录 中 进行 查看 已 打开 过 的 页 面 。 


RB 网 页 浏览 器 控件 的 模块 说 明 
模块 名 称 BOE 模块 说 明 
WebViewer( 实 例 ) 网 页 浏览 器 实例 
CanGoBack( 方 法 ) 是 否 打开 浏览 历史 记录 中 后 一 个 页 面 
CanGoForward( 方 法 ) 是 否 打开 浏览 历史 记录 中 前 一 个 页 面 
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续 表 
模块 名 称 模块 说 明 
ClearLocations( 方 法 ) 清除 位 置信 息 
GoBack( 方 法 ) 打开 浏览 历史 记录 中 后 一 个 页 面 
GoForward( 方 法 ) 打开 浏览 历史 记录 中 前 一 个 页 面 
GoHome( 方 法 ) 打开 浏览 器 的 主页 
GoToUrl( 方 法 ) 跳 转 到 指定 url 的 页 面 
vV FollowLinks V =s 
Weight currentlirl 
HomeUr1 FollowLinks 
PronptforPermission Height 
Visible HomeUrl 
Width PromptforPermission 
W ie 
读 写 属性 : FollowLinks( 是 否 允 许 用 户 通 过 单 击 页 面 的 链接 计 人 其 他 页 面 )、 
Height f£ fFe HE) , HomeUrlC E 9t hY Url) ,PromptforPermission( 是 否 允 许 访 
问 定位 功能 的 APD 、Visible( 控 件 可 见 性 )、Width( 控 件 宽度 ) 
只 读 属性 : CurrentPageTitle( 获 取 当 前 页 面 标题 )、CurrentUrl( 当 前 页 面 链接 ) 
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屏幕 布局 子 类 共 3 个 控件 ,包括 水 平 布局 (HorizontalArrangement)、 垂 直 布 局 
(VerticalArrangement) 和 表格 布局 (TableArrangement) ,各 控件 的 事件 、 属 性 和 方法 如 
K B. 12 一 表 B. 14 所 示 。 


1. 水 平 布局 


水 平 布局 可 以 将 多 个 控件 横向 排 布 ,按照 控件 被 放置 在 水 平 布 局 中 的 顺序 从 左 到 右 排列 。 
表 B.12 水 平 布 局 控件 的 模块 说 明 


模块 名 称 模块 说 明 
Horizontal Arrangement 
END 水 平 布局 实例 


TN ussirizcatal + 
Y AlisnHorizontal 
AlignVertical 
Height 
Visible 
Width 


读 写 属性 : AlignHorizontal( 控 件 在 布局 中 水 平方 向 的 排 布 方式 ,可 以 左 对 
齐 、 右 对 齐 、 居 中 或 自动 )、AlignVertical (控件 在 布局 中 竖 直 方向 的 排列 方 
式 , 可 以 上 对 齐 、 下 对 齐 、 居 中 或 自动 )、Height( 控 件 高 度 )、Visible( 控 件 可 见 
TE) 、Width( 控 件 宽度 ) 


属性 
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2. 垂直 布局 : 
垂直 布局 可 以 将 多 个 控件 纵向 排 布 ,按照 控件 被 放置 在 垂直 布局 中 的 顺序 从 上 到 下 l 
排列 。 | 
RB 垂直 布局 控件 的 模块 说 明 : 
模块 名 称 模 3 模块 说 明 ' 
VerticalArrangement | 
(属性 ) 垂直 布局 实例 
属性 
读 写 属性 : AlignHorizontal( 控 件 在 布局 中 水 平方 向 的 排 布 方式 ,可 以 左 对 
齐 、 右 对 齐 、 居 中 或 自动 )、AlignVertical (控件 在 布局 中 竖 直 方向 的 排列 方 
式 , 可 以 上 对 齐 、 下 对 齐 、 居 中 或 自动 )、Height( 控 件 高 度 )、Visible( 控 件 可 见 
TE) , Width Ez (fF S HE) 
3. 表格 布局 
表格 布局 将 屏幕 划分 为 表格 ,通过 指定 行 (Rows) 和 列 (Columns) 可 以 控制 格子 的 
数量 。 
表 B.14 表格 布局 控件 的 模块 说 明 
模块 名称 BOX 模块 说 明 
TableArrangement( 实 例 ) TableArrangementl * 表格 布局 实例 
属性 
读 写 属 性 : Height( 控 件 高 度 )、Visible( 控 件 可 见 性 ) 、Width( 控 件 宽度 ) 
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媒体 控件 共 9 个 控件 ,包括 录像 机 (Camcorder)、 相 机 (Camera)、 选 图 工具 
(ImagePicker) 、 音 频 播 放 器 (Player) .音效 播放 器 (Sound)、 录 音 机 (SoundRecorder) , i 
音 识别 (SpeechRecognizer) .语音 生成 (TextToSpeech) 和 视频 播放 器 (VideoPlayer) ,各 
控件 的 事件 .属性 和 方法 如 表 B. 15 一 表 B. 23 所 示 。 


1. 录像 机 
录像 机 的 主要 功能 是 利用 手机 的 摄像 头 实现 视频 的 录制 。 
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模块 名 称 BOR 模块 说 明 
Camcorder( 实 例 ) 录像 机 实例 
AfterRecording( 事 件 ) r EE NEN 代表 
RecordVideo( 方 法 ) 启动 手机 摄像 头 的 录制 功能 
2. 相机 
相机 主要 实现 手机 的 拍照 功能 。 
表 B.16 相机 控件 的 模块 说 明 
模块 名 称 模块 说 明 
Camera( 实 例 ) 相机 实例 
AfterPicture( 事 件 ) ery PE ft sqa 是 
TakePicture( 方 法 ) 实现 相机 的 拍照 功能 
3. 选 图 工具 


选 图 工具 的 主要 功能 是 从 手机 相册 的 图 片 库 中 选取 图 片 。 
表 B.17 选 图 工具 控件 的 模块 说 明 


模块 名 称 模 块 模块 说 明 
ImagePicker( 实 例 ) lmagePickerl " 选 图 工具 实例 
AfterPicking( 事 件 ) 选 图 后 事件 
BeforePicking( 事 件 ) 选 图 前 事件 
GotFocus( 事 件 ) 获取 焦点 事件 
LostFocus( 事 件 ) 失去 焦点 事件 


HTB 控件 库 


续 表 
模块 名 称 & K 模块 说 明 
Open( 方 法 ) 打开 选 图 工具 浏览 图 片 
V BackgroundColor V BackgroundColor 
Enabled Enabled 
Height Height 
Image Image 
ShowFeedback Selection 
Text ShowFeedback 
TextColor Text 
属性 Visible TextColor 
Width Visible 
Width 
读 写 属 性 : BackgroundColor( 控 件 的 背景 色 )、Enabled( 控 件 的 可 用 性 )、 Height 
(控件 高 度 ) Image( 背 景 图 片 )、ShowFeedBack( 显 示 视 觉 反馈 效果 )、Text( 文 
本 内 容 )、TextColor( 文 本 颜色 )、Visible( 控 件 可 见 性 )、Width( 控 件 宽度 ) 
只 读 属 性 : Selection( 返 回 所 选取 图 片 的 路 径 》 
4. 音频 播放 器 


音频 播放 器 用 来 播放 音频 文件 ,一 般 用 于 播放 时 间 较 长 的 音频 文件 ,如 音乐 .录音 等 。 
表 B.18 音频 播放 器 控件 的 模块 说 明 


模块 名 称 模块 说 明 
Player( 实 例 ) 音频 播放 器 实例 
Completed( 事 件 ) 播放 完毕 事件 
Pause( 方 法 ) 暂停 播放 
Start( 方 法 ) 开始 播放 
Stop( 方 法 ) 停止 播放 
Vibrate( 方 法 ) 使 手机 震动 , millisecondes 是 震动 时 


间 ,单位 为 毫秒 


属性 


f Ë )] 
| V IsPlaying 

Loop 

Source 


读 写 属性 : Loop( 是 否 循环 播放 )、Source( 播 放 文件 的 路 径 )、Volume( 设 置 播 
放 的 音量 ,为 1 到 100 之 间 的 数字 ) IsPlaying( 播 放 器 是 否 正在 播放 ) 
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5. 音效 播放 器 
音效 播放 器 一 般 可 用 来 播放 较 短 的 音频 文件 或 者 控制 手机 的 震动 。 


表 B.19 音效 播放 器 控件 的 模块 说 明 


模块 名 称 模 R 模块 说 明 
Sound( 实 例 ) 音效 播放 器 实例 
Pause( 方 法 ) CT 暂停 播放 
Play( 方 法 ) CT 开始 播放 
Resume( 方 法 ) Gem Resune | 暂停 播放 后 继续 播放 
Stop( 方 法 ) Gmm -sion | 停止 播放 
EERTE PES bebo 是 震动 时 间 , 单 
" 
读 写 属性 : MinimumInterval( 音 频 间 最 短 时 间 间 隔 )、Source( 播 放 的 音效 源 ) 


6. 录音 机 
录音 机 的 主要 功能 是 利用 手机 实现 音频 的 录制 。 


表 B.20 录音 机 控件 的 模块 说 明 


模块 名 称 模 块 模块 说 明 
SoundRecorder( 实 例 ) 录音 机 实例 
GIGO SoundRecorderi > BU Es] 录制 结束 事件 d 代表 
结 + soun 
AfterSoundRecorded( 事 件 ) 音频 的 存储 路 径 
LIE SoundRecorderl * BEIT Euo E 
StartedRecording GRE fF.) d - — 开始 录制 事件 
when Sunan Corder: ` PE 
StoppedRecording( 事 件 ) = = 停止 录制 事件 
Play Jr ik) 开始 录制 
Stop( 方 法 ) 停止 录制 


7. 语音 识别 


HTB 控件 库 


语音 识别 的 主要 功能 是 利用 语音 识别 技术 将 用 户 的 语音 信息 转换 为 文字 。 


表 B.21 语音 识别 控件 的 模块 说 明 


模块 名 称 


BOE 


模块 说 明 


SpeechRecognizer (实例 ) 


语音 识别 实例 


when . AfterGettingText 


获取 文字 后 事件 ,其 中 result 


AfterGettingText( 事 件 ) 为 识别 出 的 文字 结果 
startedGettingText( 事 件 | B | 启动 前 触发 的 事件 
GetText( 方 法 ) 从 语音 中 识别 文字 
mt 


8. 语音 生成 


读 属 性 : Result( 语 音 识别 出 的 文字 ) 


语音 生成 控件 的 主要 功能 是 将 文字 转换 为 语音 。 


表 B.22 语音 生成 控件 的 模块 说 明 


模块 名 称 BOX 模块 说 明 
TextToSpeech( 实 例 ) [TextToSpeechl `] 语音 生成 控件 实例 
when AfterSpeaking 
i »resul 
AfterGettingText 3 (f) (BGRSS WEE a ERR 


的 语音 结果 


E arTextroSpeech - Jawapan 


StartedGettingText( 3 f) 生成 语音 前 事件 
GetText( 方 法 ) Oe 将 文字 转换 为 语音 
p 
Language Language 
属性 Result 


RÆ) „Result (RE) 


读 写 属 性 : Country( 产 生 的 语言 的 国家 代码 ) Language # f 18 ñ hY 
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9. 视频 播放 器 


视频 播放 器 主要 用 于 播放 视频 文件 ,提供 基础 的 播放 控制 功能 ,包括 播放 、 和 暂停 、 调 整 
播放 位 置 等 。 


表 B.23 视频 播放 器 控件 的 模块 说 明 


模块 名 称 模 块 模块 说 明 
VideoPlayer( 实 例 ) 视频 播放 器 实例 
dm . Completed 
Complete( 事 件 ) 播放 完毕 事件 
GetDuration( 方 法 ) 获取 视频 长 度 
Pause( 方 法 ) 暂停 播放 
SeekTo( 方 法 ) 调整 播放 位 置 到 所 指定 时 间 处 
Start( 方 法 ) 开始 播放 
V FullScreen 
Height 
Source Visible 
属性 Visible Width 
Width 
读 写 属性 : FullScreen( 播 放 器 是 否 全 屏 )、Height( 视 频 播放 器 的 高 度 ) «Source 
频 文件 的 路 径 ) 、Visible( 视 频 播放 器 的 可 见 性 )、Width( 视 频 播放 器 的 宽度 ) 


B4 动画 控件 

动画 控件 子 类 共 3 个 控件 ,包括 球体 (Ball) 、 夯 布 (Canvas) 和 图 像 精 录 (ImageSprite) ,各 
控件 的 事件 .属性 和 方法 如 表 B. 24 一 表 B. 26 所 示 。 

1. 球体 


球体 是 球形 状 的 图 像 精灵 ,可 根据 属性 进行 移动 ,也 可 以 与 其 他 图 像 精灵 、 球 体 或 画 
布 边缘 产生 碰撞 事件 ,用 户 可 对 其 进行 触摸 和 拖 忠 操作 。 
表 B.24 球体 控件 的 模块 说 明 


模块 名 称 Box 模块 说 明 
Ball( 实 例 ) 球体 实例 
CollidedWith( 事 When [Balll "] MI .CollidedWith 碰撞 事件 ,球体 与 其 他 精灵 
"n 发 生 碰撞 的 事件 


DB 控件 库 


续 表 
模块 名 称 模块 说 明 
拖 史 事件 , 当 手 指 在 画布 上 
拖 踊 球体 时 触发 本 事件 。 
startX.startY; 拖 电 事件 开 
Dragged Pee EOD: ae 始 时 XY 坐 标 值 。 
(事件 ) prevX、prevY: 上 一 个 拖 电 
事件 产生 时 的 XY 坐标 值 。 
currentX, currentY; 拖 电 结 
IRET X.Y 坐标 轴 数 值 
滑动 事件 ,只 有 手指 在 画布 
上 快速 滑动 时 触发 本 事件 。 
ay: 滑动 事件 的 初始 坐标 。 
speed: 滑动 事件 的 速度 ( 音 
Flung( 事 件 ) 位 像素 /毫秒 ) 。 
heading: 滑动 事件 的 角度 
(0—360), 
xvel.yvel; 3 HE dE X fü fü 
立轴 的 分 量 
触 壁 事件 , 当 球 与 画布 边缘 
EdgeReached 时 触发 本 事件 ,并 返回 所 到 
(事件 达 边 缘 的 位 置信 息 , 其 中 
edge 值 是 返回 的 边缘 位 置 
信息 
NoLonger 不 再 碰撞 事件 , 当 球 体 与 其 
ColllidedWith 他 精灵 从 碰撞 状态 分 离 时 
(事件 ) 触发 本 事件 
触摸 事件 , 当 用 户 对 球 进行 
Touched 触摸 时 触发 本 事件 。 
(事件 ) cr.y: 触 控 点 的 X、Y 轴 坐 
标 值 
按 下 事件 , 当 用 户 对 球 进行 
TouchDown 按 下 操作 时 触发 本 事件 。 
(事件 ) xy: 手指 按 下 时 触摸 点 的 
X.Y fib bs f 
抬 起 事件 , 当 用 户 对 球 进行 
T 按 下 操作 后 再 抬 起 时 触发 
ouchUp 
(事件 ) 本 事件 。 
xy: 手指 抬 起 时 触摸 点 的 
X. Y 轴 坐 标 值 
Boundce 球体 反弹 ,一 般 在 球体 与 精 
(方法 ) 灵 磁 撞 后 使 用 
CollidingWith 返回 球体 是 否 与 指定 精灵 
(方法 ) (other) 发 生 碰 撞 
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续 表 
模块 名 称 模 K 模块 说 明 
MoveToBounds 若 球 移动 到 画布 边界 外 ,可 
(方法 ) 调用 本 方法 将 其 拉 回 界 内 
MoveTo 把 球体 移动 到 指定 的 位 置 
(方法 ) (x,y) 
PointInDirection " 
(方法 ) 将 球 旋 转 指向 坐标 (z,y) 
PointTowards 让 球 向 目标 精灵 (target) 
(方法 ) 移动 
e s Barri NópEnabled ， 
V Enabled V Enabled 
Heading Heading 
Interval Interval 
PaintColor PaintColor 
Radius Radius 
Speed Speed 
Visible Visible 
x 
属性 Y 
z 
读 写 属 性 : Enabled( 球 体 是 否 可 用 )、Heading( 球 体 的 方向 ,0 度 向 右 移动 ,90 度 时 
向 上 移动 )、Interval( 球 体 的 移动 频率 ,单位 为 毫秒 )、PaintColor( 球 体 的 颜色 )、 
Radius( 球 体 的 半径 )、Speed( 球 体 的 移动 速度 ,单位 为 像素 )、Visible( 球 体 是 否 可 
见 ) .X( 水 平方 向 上 球体 左边 缘 的 坐标 )、Y( 竖 直方 向 上 球体 上 边缘 的 坐标 )、Z( 球 
体位 置 的 Z 坐标 ) 
2. 画布 
画布 是 一 种 可 在 其 上 绘制 图 像 的 控件 ,除了 作为 绘制 图 形 的 承载 体 以 外 ,还 经 常 作为 
游戏 的 背景 画面 。 
A B.25 画布 控件 的 模块 说 明 
模块 名 称 模 块 模块 说 明 
Canvas( 实 例 ) 画布 实例 
Happ. 
startX.startY; 拖 电 起 
始 位 置 的 坐标 值 。 
prevX、prevY: 上 一 拖 
Dragged( 事 件 ) 忠 事 件 的 坐标 值 。 
currentX、currentY: 当 
前 拖 电 点 的 坐标 值 。 
draggedSprite: 被 拖 电 
的 精灵 实例 


附录 B 控件 库 


模块 名 称 


模块 说 明 


Flung( 事 件 ) 


shen CINO Fir 


快速 滑动 事件 。 

zy: 滑动 事件 初始 坐标 。 
speed: 滑动 事件 的 速度 
(单位 像素 /毫秒 ) 。 
heading: 滑动 事件 的 角 
度 (0 一 360) 。 

xvel, yve: 速度 在 X fü 
和 站 轴 的 分 量 。 
flungSprite: 被 快速 滑 
动 的 精灵 


Touched( 事 件 ) 


mhen CAES .Touched 


触 碰 事 件 。 

c.y: 触 控 点 的 X、Y 轴 
坐标 值 。 

touchedSprite, 被 触 控 
的 精灵 


TouchDown GE ff) 


按 下 事件 。 
z.y: 手指 按 下 时 触 控 
点 的 X、Y 轴 坐 标 值 


TouchUp( 事 件 ) 


抬 起 事件 。 
Zz,y: 手指 抬 起 时 触 碰 
点 的 X\Y 轴 坐标 值 


Clear( 方 法 ) 


清空 画布 元 素 , 如 果 夯 
布 上 已 设置 图 片 ,此 图 
片 会 被 清除 


DrawCircle( 方 法 ) 


在 画布 上 绘制 圆 形 图 
案 , 其 中 ,z y 为 圆心 
坐标 ,r 为 半径 


DrawLine( 方 法 ) 


在 画布 上 从 (zl,yl1) 点 
到 (z2,y2) 点 绘制 直线 


DrawPoint( 方 法 ) 


在 画布 上 绘制 圆 点 图 
案 , 位 置 坐标 为 (x,y) 


DrawText( 方 法 ) 


在 画布 上 坐标 为 (x,y) 
的 位 置 显示 文本 text 的 
内 容 


DrawTextAtAngle( 方 法 ) 


在 画布 上 坐标 为 C(z,y) 
的 位 置 以 angle 角度 显 
示 文 本 text 的 内 容 
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续 表 


模块 名 称 


模块 说 明 


GetBackgroundPixelColor 
(方法 ) 


获取 画布 上 坐标 为 
(zyy) 点 的 背景 色 


GetPixelColor( 方 法 ) 


获取 画布 上 坐标 为 
(zy) 的 点 的 颜色 


SaveAs( 方 法 ) 


将 画布 当前 状态 截图 存 
储 在 sd 卡 上 ,文件 名 为 
fileName( 只 能 是 JPEG, 
JPG、PNG 文件 ), 并 返 
回 该 文件 的 完整 存储 
路 径 


Save( 方 法 ) 


将 画布 当前 状态 截图 存 
储 在 sd 卡 上 ,并 返回 该 
文件 完整 的 存储 路 径 


SetBackgroundPixelColor 
(方法 ) 


设置 画布 某 个 点 的 背景 
颜色 ,x 和 y 表示 画布 


E PE 
V BackgroundColor 
Backarou Backgroundlaage 
Font FontSize 
Height Height 
LineTidth Lineidth 
属性 Weile Vete 
Width Width 
读 写 属性 : BackgroundColor( 画 布 背景 色 )、BackgroundColor( 画 布 背 景 图 
片 )、FontSize( 画 布 字 体 大 小 )、Height( 画 布 的 高 度 )、LineWidth( 画 笔 宽 
度 )、PaintColor( 画 笔 颜色 )、Visible( 画 布 可 见 性 )、Width( 夯 布 的 宽度 ) 
3. 图 像 精 灵 


图 像 精灵 是 一 种 可 在 画布 中 自由 移动 的 图 像 , 并 可 与 球体 (Ball) 、 其 他 图 像 精灵 和 夯 
布 边缘 产生 碰撞 事件 ,图 像 精灵 经 常用 于 开发 游戏 。 


表 B.26 图 像 精 灵 控 件 的 模块 说 明 


模块 名 称 模 块 模块 说 明 
ImageSprite( 实 例 ) 图 像 精 灵 实 例 
L InageSpritel * IS a 碰撞 事件 ,图 像 精 灵 
CollidedWith( 事 件 ) 与 其 他 精灵 发 生 碰撞 
的 事件 


HTB 控件 库 


模块 名 称 


模块 说 明 


Dragged( 事 件 ) 


拖 电 事 件 , 当 手指 在 画 
布 上 拖 忠 图 像 精灵 时 
触发 本 事件 。 
startX.startY; 拖 电 事 
件 开始 时 X、Y 坐标 值 。 
prevX,prevcY: 上 一 个 
拖 电 事 件 产生 时 的 X、 
立 坐标 值 。 

currentX, currentY : 
J a ph k hh X\Y 坐标 
LESE 


Flung £ (f) 


ImageSpritel ` Sani 


滑动 事件 ,只 有 手指 
在 画布 上 快速 滑动 时 
触发 本 事件 。 

zy: 滑动 事件 初始 
坐标 。 

speed: 滑动 事件 的 速 
度 ( 单 位 像素 /毫秒 ) 。 
heading; 滑动 事件 的 
角度 (0 一 360) 。 

xvel, yve: 速度 在 X 
轴 和 并 轴 的 分 量 


EdgeReached( 事 件 ) 


触 壁 事件 , 当 画 布 精 
灵 与 画布 边缘 时 触发 
本 事件 ,并 返回 所 到 
达 边 缘 的 位 置信 息 ， 
edge 值 是 返回 的 边缘 
位 置信 息 


NoLonger CollidingWith 
(事件 ) 


NoLongerCollidingWith 


不 再 碰撞 事件 , 当 图 
像 精 灵 与 其 他 精灵 从 
碰撞 状态 分 离 时 触发 
本 事件 


Touched( 事 件 ) 


触摸 事件 , 当 用 户 对 
图 像 精灵 进行 触摸 时 
触发 本 事件 。 

xy: 触 控 点 的 X、Y 
LEX 


TouchDown GR ff) 


按 下 事件 , 当 用 户 对 
图 像 精 灵 进 行 按 下 操 
作 时 触发 本 事件 。 
zo 手指 按 下 时 触摸 
点 的 X、Y 轴 坐 标 值 
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续 表 


模块 名 称 


模块 说 明 


TouchUp( 事 件 ) 


抬 起 事件 , 当 用 户 对 
图 像 精灵 进行 按 下 操 
作 后 再 抬 起 时 触发 本 
事件 。 

coy 手指 抬 起 时 触摸 
点 的 X、Y Sd bs fH 


Boundce( 方 法 ) 


图 像 精灵 反弹 ,一 般 
在 图 像 精灵 与 精灵 碰 
撞 后 使 用 


CollidingWith Jr i£) 


返回 图 像 精 灵 是 否 与 
指定 精灵 (other) 发 生 
碰撞 


MoveIntoBounds( 方 法 ) 


若 图 像 精 灵 移 动 到 画 
布 边界 外 ,可 调用 本 
方法 将 其 拉 回 界 内 


MoveTo( 方 法 ) 


把 图 像 精 灵 移 动 到 指 
定 的 位 置 Cz,y) 


了 PointInDirection( 方 法 ) 


mageSpritel ` Blau 


将 图 像 精 灵 旋 转 指 向 
坐标 (zy) 


PointTowards( 方 法 ) 


让 图 像 精 灵 向 指定 的 
目标 精灵 (target) 移 动 


属性 


V Enabled 
Heading 
Height 
Interval 
Picture 
Rotates 
Speed 
Visible 
Width 


V Enabled 
Heading 
Height 
Interval 
Picture 
Rotates 


Speed 
Visible 
Width 


读 写 属 性 : Enabled (dè # nf JH) , Heading( 球 移动 的 方向 ,0 度 向 右 移动 ， 
90 度 时 向 上 移动 )、Height( 控 件 的 高 度 ) Interval( 移 动 频率 ,单位 为 毫秒 )、 
Picture( 背 景 图 片 )、Rotates( 若 设置 为 true, 图 像 精灵 按 Heading 指定 的 方 
向 旋转 ;车 设置 为 false, 当 heading 方向 改变 时 , 仍 绕 其 中 心 旋转 )、Speed 
(移动 速度 ,单位 为 像素 )、Visible( 是 否 可 见 )、Width( 控 件 的 宽度 )、X( 水 平 
方向 上 图 像 精灵 左边 缘 的 坐标 )、Y( 竖 直方 向 上 图 像 精灵 上 边缘 的 坐标 )、 


Z( 图 像 精灵 位 置 的 Z 坐标 ) 


B5 传感器 控件 
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感应 器 控件 共 5 个 控件 ,包括 AccelerometerSensor、 BarcodeScanner、 LocationSensor、 
NearField 和 OrientationSensor, 各 控件 的 事件 ,属性 和 方法 如 表 B. 27 一 表 B. 31 Bron. 


1. 加 速 传感器 
加 速 传感器 的 主要 功能 是 获取 手机 加 速度 感应 器 的 状态 ,并 侦 测 设备 三 维 空间 的 晃 
动情 况 。 
表 B.27 加 速 传感器 控件 的 模块 说 明 
模块 名 称 模 块 模块 说 明 
AccelerometerSensor( 实 例 ) 加 速度 传感器 实例 
AccelerationChanged( 事 件 ) 加 速度 感应 器 的 值 改变 事件 
Shaking( 事 件 ) 手机 晃动 事件 
< Enab1ed 
T em 
accel 
YAecel 
Zhecel 
属性 


读 写 属性 : Enabled( 加 速 感应 器 的 可 


Fi E) , MinimumInterval (F 9L 2€ 


动 的 最 小 时 间 间 隔 ) .Sensitivity( 加 速 感应 器 的 敏感 性 ) 
只 读 属 性 : Available( 是 否 存 在 方向 加 速度 传感器 ).XAccel( 加 速度 传 
感 器 X 轴 的 变化 量 )`YAccel( 加 速度 传感器 Y 轴 的 变化 量 )、ZAccel 


(加 速度 传感器 Z 轴 的 变化 量 ) 


2. 条 形 码 扫描 器 


条 形 码 扫描 器 的 主要 功能 是 实现 条 形 码 扫描 。 
表 B.28 条 形 码 扫描 器 控件 的 模块 说 明 


模块 名 称 BOR 模块 说 明 
BarcodeScanner( 实 例 ) | Grr | 条 形 码 扫 描 器 实例 
ET San 是 扫 找 
DoScan( 方 法 ) CH ZI 启动 摄像 头 进行 扫 找 
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模块 名 称 


BOE LE S BH 


属性 


只 读 属性 : Result( 返 回 扫描 结果 ) 


3. 位 置 传感器 


位 置 传感器 的 主要 功能 是 使 用 设备 的 GPS 或 者 其 他 定位 方法 (移动 基站 或 无 线 网 
络 ) 获 取 手 机 的 当前 位 置信 息 。 


X B.29 位 置 传感器 控件 的 模块 说 明 


模块 名 称 BOE LES BH 

LocationSensor( Sz fj) LocationSensorl " 位 置 传感器 实例 
when LocationChanged 
LocationChanged " 
(事件 ) : E 
when StatusChanged N I 
StatusChanged( 事 件 ) 设备 的 服务 提供 者 状态 改变 
事件 

LatitudeFromAddress 
(方法 ) 获取 指定 地 址 的 纬度 
LongitudeFromAddress 
(方法 ) 获取 指定 地 址 的 经 度 


属性 


| Accuracy 
Altitude 
AvailableProviders 
CurrentAddress 
DistanceInterval 
Enabled 
HasAccuracy 


V DistanceInterval 
Enabled 
Providerlocked 
ProviderName 
TimeInterval 


HasAltitude 
HasLongitudeLatitude 
Latitude 

Longitude 
ProviderLocked 


ProviderName 


TimeInterval 


读 写 属性 : DistancelInterval( 位 置 更 新 的 最 小 变化 距离 )、Enabled( 位 置 传 感 
器 是 否 可 用 )、ProviderLocked (Android 设备 是 否 锁定 服务 提供 者 )、 
ProviderName( 位 置 服务 的 提供 商 名 称 )、TimelInterval( 位 置 更 新 的 最 小 时 
间 间 隔 ) 

只 读 属性 : Accuracy( 手 机 所 在 位 置 的 精度 等 级 )、Altitude( 手 机 所 在 位 置 的 
海拔 高度)、AvailableProviders (手机 可 用 的 服务 提供 者 清单 )、 
CurrentAddress( 手 机 的 当前 位 置 )、HasAccuracy (手机 是 否 可 以 回 传 精 
度 )、HasAltitude( 手 机 是 否 可 以 回 传 海拔 高 度 )、HasLongitudeLatitude( 手 
机 是 否 可 以 回 传经 度 和 纬度 )、Latitude( 手 机 所 在 位 置 的 纬度 )、Longitude 
(手机 所 在 位 置 的 经 度 ) 


4. 近 场 通信 
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近 场 通信 控件 提供 了 手机 在 彼此 靠近 的 情况 下 进行 数据 交换 的 功能 。 


表 B.30 近 场 通信 控件 的 模块 说 明 


模块 名 称 BOE LE S BH 
Nearfield( Sz fill) 近 场 通信 实例 
when TagRead kz 
TagRead( 事 件 ) 2E M ETIN SNUS 
TagWritten( 事 件 ) ;.-—-— Aa L: 
V LastMessage 
ReadMode 
TextToWr iti 
属性 Yritelype li 
读 写 属性 : ReadMode( 读 标签 的 模式 ) ,TextToWrite( 将 要 写 人 标签 的 内 容 ) 
只 读 属性 : LastMessage( 最 后 通信 的 信息 )、 WriteType( 写 标签 的 类 型 ) 
5. 方向 传感器 
方向 传感器 用 来 获取 与 方向 相关 的 数据 ,包括 倾斜 角 ,方位 角 倾斜 程度 、 翻 转角 和 转 
动 角 。 
表 B.31 方向 传感器 控件 的 模块 说 明 
模块 名 称 BOX 模块 说 明 
OrientationSensor 
is] fle) 
ns === — 
OrientationChanged " 
(事件 ) 方向 变化 事件 


属性 


V Angle 
Available 


Azimuth 
Enabled 
Magnitude 
Pitch 
Roll 


读 写 属性 : Enabled( 方 向 传感器 是 否 可 用 ) 
只 读 属 性 : Angle( 手 机 的 倾斜 角 大 小 )、 Available( 手 机 是 否 存在 方向 传感器 )、 
Azimuth( 手 机 的 方位 角 )、.Magnitude( 手 机 的 倾斜 程度 ,用 0 一 1 的 数字 表示 )、 
Pitch( 手 机 的 翻转 角 ) 、Roll( 手 机 的 转动 角 ) 
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B6 Mif 


社交 控件 子 类 共 6 个 控件 ,包括 选取 联系 人 (ContactPicker)、 邮 件 地 址 工具 
(EmailPicker) ,d£ 5 ( PhoneCalD , 3€ Ht 5 fij ( PhoneNumberPicker) , & fri E (Texting) fl 
推 特 (Twitter) ,各 控件 的 事件 .属性 和 方法 如 表 B. 32 一 表 B. 37 所 示 。 


1. 选取 联系 人 


选取 联系 人 的 功能 是 让 用 户 从 手机 的 通讯 录 获 得 联系 人 信息 ,这 些 信息 包括 联系 人 
的 姓名 、 头 像 和 电子 邮件 地 址 。 


表 B.32 选取 联系 人 控件 的 模块 说 明 


模块 名 称 模块 模块 说 明 
ContactPicker( 实 例 ) ContactPickeri ” 选取 联系 人 实例 
afterPicking( 事 件 ) ER 2i. 选择 后 事件 ,在 用 户 选择 目标 联系 人 
后 产生 
TE um ES EN 选择 前 事件 ,在 用 户 打 开通 讯 录 ,但 尚 
BeforePicking( 事 件 ) 未 选择 目标 联系 人 时 产生 
oe YP ContactPicker Tr 获取 焦点 事件 
LostFocus( 事 件 ) i E 失去 焦点 事件 
Open( 方 法 ) 打开 联系 人 列表 供 选 择 
V BackgroundColor V BackgroundColor 
Enabled ContactName 
Height EmailAddress 
Image Enabled 
ShowFeedback Height 
Text Inage 
TextColor Picture 
Visible ShowFeedback 
Width Text 
属性 TextColor 
Visible 
Width 
读 写 属性 : BackgroundColor RÈ E ) , Enabled GÈ f n] FH 5) , Height GÈ fF 
高 度 ) ,Image( 控 件 图 片 )、ShowFeedBack( 是 否 有 视觉 反馈 )、Text( 显 示 的 文 
Æ) .TextColor( 文 本 的 颜色 ) 、Visible( 控 件 可 见 性 )、Width( 控 件 的 宽度 ) 
只 读 属 性 : ConstactName( 联 系 人 姓名 )、EmailAddress (联系 人 地 址 )、Picture 
(联系 人 头像 ) 
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2. 邮件 地 址 工具 
邮件 地 址 工具 在 用 户 输入 联系 人 的 电子 邮件 地 址 时 提供 自动 完成 邮件 地 址 输入 的 


功能 。 
表 B.33 邮件 地 址 工具 控件 的 模块 说 明 
模块 名 称 模 块 模块 属性 
ContactPicker( 实 例 ) FmailPickerl " 邮件 地 址 工具 实例 
when Eanbickerl .GotFocus 
GotFocus( 事 件 ) — 获取 焦点 事件 
LostFocus( 事 件 ) 失去 焦点 事件 
eri r G 
V BackgroundColor 
Enabled 
FontSize FontSize 
Height Height 
Hint Hint 
Text Text 
属性 TextColor TextColor 
Visible Visible 
Width Width 
读 写 属性 : BackgroundColor( #f #t Bi & ) , Enabled (45 f/F 8T HH HE) , FontSize C5 f 
大 小 )、Height( 控 件 高 度 )、Hint( 用 户 提示 信息 )、Text( 显 示 文 本 )、TextColor 
(文本 颜色 )、Visible( 控 件 可 见 性 )、Width( 控 件 宽度 ) 
3. 拨号 


拨号 是 一 个 非 可 视 化 控件 ,用 于 向 指定 的 电话 号 码 拨打 电话 。 


表 B.34 拨号 控件 的 模块 说 明 


模块 名 称 BOE 模块 属性 
PhoneCall1 (实例 ) 拨号 控件 实例 
3 调用 手机 的 拨号 界面 ,拨打 PhoneNumber 
PAYAYAY” — k= 
t tc PhoneNumber *. 
属性 
读 写 属性 : PhoneNumber( 要 拨打 的 电话 号 码 ) 
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4. 选取 号 码 


选取 号 码 控件 可 以 获取 手机 通讯 录 中 的 联系 人 信息 ,这 些 信息 包括 联系 人 的 姓名 、 头 
像 ,电子 邮件 地 址 和 电话 号 码 。 


X B.35 选取 号 码 控件 的 模块 说 明 


模块 名 称 模 3 模块 属性 
PhoneNumberPicker š 
(实例 ) 选取 号 码 控件 实例 
when CITT .AfterPicking |; 3 z 
AfterPicking( 事 件 ) | E à; I 
BeforePicking DXEucuzGSDTENEENMNEN aaepe yapa LET 
(事件 ) 但 是 尚未 选择 目标 联系 人 时 产生 
when GotFocus 
GotFocus( 事 件 ) 获取 焦点 事件 
LostFocus( 事 件 ) 失去 焦点 事件 
Open( 方 法 ) 打开 联系 人 列表 供 选 择 
V BackgroundColor V BackgroundColor 
Enabled ContactName 
Height Emai lAddress 
Image Enabled 
ShosFeedback Height 
Text Image 
TextColor PhoncNumber 
Visible Picture 
Width ShosFeedback 
Text 
nt Eu 
Width 
读 写 属性 : BackgroundColor (控件 的 背景 颜色 )、Enabled (控件 的 可 用 性 )、 
Height( 控 件 的 高 度 ) Image( 控 件 的 背景 图 片 )、ShowFeedBack( 是 否 有 视觉 反 
馈 )、Text( 控 件 显示 的 文本 )、TextColor( 控 件 显 示 的 文本 的 颜色 )、Visible( 控 件 
的 可 见 性 )、Width( 控 件 的 宽度 ) 
只 读 属 性 : ConstactrName( 目 标 联系 人 姓名 ) .EmailAddress( 目 标 联系 人 地 址 )、 
Picture( 目 标 联系 人 头像 )、.PhoneNumber( 目 标 联系 人 电话 号 码 ) 
s. 短信 息 


短信 息 控件 主要 用 来 发 送 和 接收 短信 息 。 
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表 B.36 短信 息 控件 的 模块 说 明 


模块 名 称 模 块 模块 属性 
Texting( 实 例 ) 短信 息 实例 
et EUN MessageReceived 信息 接收 事件 ,在 接收 短信 后 产生 ， 
am —— number 是 发 送 方 的 电话 号 码 ， 
messageText 是 短信 息 内 容 
SendMessage s 
(方法 ) 发 送 短信 息 
V GoogleVoiceEnabled V Goog leVoiceEnabled 
Message Message 
PhoneNumber PhoneNumber 
属性 ReceivingEnabled ReceivingEnabled 
读 写 属性 : GoogleVoicdEnabled( 是 否 人 允许 使 用 GoogleVoice lli 4) , Message Ci fri 
的 内 容 )、PhoneNumber( 发 短信 的 目标 电话 号 码 )、ReceivingEnabled( 是 否 允 许 接 
收 短信 ) 
6. 推 特 


推 特 是 一 个 社交 网 络 和 一 个 微 博 客服 务 , 可 以 让 用 户 更 新 不 超过 140 个 字符 的 消息 ， 
通过 该 模块 可 以 调用 Twitter 的 服务 。 


模块 名 称 


表 B.37 推 特 控 件 的 模块 说 明 


模 块 模块 说 明 


Twitter( 实 例 ) 


推 特 实例 


DirectMessageReceived 


通过 RequestDirectMessages 方法 


(事件 ) 获取 所 查询 的 信息 的 事件 
FollowersReceived 通过 RequestFollowers 方法 获取 所 
(事件 ) 查询 的 在 线 好 友 名 单 的 事件 


FriendTimelineReveived 


通过 RequestFriendTime 方法 获取 


(事件 ) 所 查询 的 信息 所 产生 的 事件 
IsAuthorized( 事 件 ) Das ERNER 
MentionsReceived 登录 用 户 调用 RequestMentions 后 
(事件 ) 获取 结果 时 产生 的 事件 

when TT WD - SearchSuccessful 
SearchSuccessful( 事 件 ) Twitter 中 搜索 成 功 事件 


可 视 化 开发 Android 应 用 程序 


— i | ++ X HE A App Inventor 2 (第 2 收 ) 


# 
模块 名 称 模 模块 说 明 
Authorize( 方 法 ) SE - Tree Rege 
页 面 
CheckAuthorized CT 检测 用 户 输入 的 用 户 名 及 密码 信息 
(方法 ) 是 否 正确 
DeAuthorize( 方 法 ) CD ENSEM 退出 已 登录 的 Twitter 应 用 程序 
DirectMessage( 方 法 ) 向 用 户 (user) 发 送 消息 (message) 
Follow( 方 法 ) 关注 指定 的 使 用 者 (user) 
RequestDirect Messages 
方法》 CE | 接收 最 新 的 消息 
RequestFollowers ez 获取 正在 关注 我 的 用 户 列表 
(方法 ) 
RequestFriendTimeline 
(方法 ) Gy RED 获取 关注 我 的 用 户 的 最 新 消息 
RequestMentions CU E 获取 有 关 其 他 人 以 及 登录 用 户 的 最 
Ori 新 消息 列表 
SearchTwitter( 方 法 ) 在 Twitter 中 搜索 内 容 
StopFollowing (方法 ) 取消 对 指定 用 户 (user) 的 关注 
Tweet( 方 法 ) 发 布 消息 
ms 发 布 带 有 图 片 (ImagePath) 的 消息 
DirectMessages 
Followers 
FriendTimeline 
Mentions 
SearchResults 
TwitPic API Key 
属性 Username 


读 写 属性 : ConsumerKey (Twitter JH 2E 88 iA JH P: E () $ë 88) , ConsumerSecret 
(Twitter 用 来 确认 用 户 身 份 的 密码 ) .PhoneNumber( 上 传 图 片 的 密 钥 ) 

只 读 属性 : DirectMessages( 登 录用 户 的 最 近 消息 列表 )、Followers( 登 录用 
户 的 粉丝 列表 )、FriendTimeline( 用 户 关 注 的 好 友 的 20 个 最 新 的 消息 列 
3X) 、Mentions( 登 录用 户 的 提醒 消息 列表 )、SearchResults(SearchTwitter 方 
法 的 搜索 结果 列表 ) .Username( 授 权 用 户 的 用 户 名 ) 
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B7 存储 控件 

存储 子 类 同 有 3 个 控件 ,包括 FusiontablesControl、TinyDB、TinyWebDB, 各 控件 的 
事件 、 属 性 和 方法 如 表 B. 38 一 表 B. 40 所 示 。 

1. 融合 表 控制 器 


融合 表 控 制 器 的 主要 功能 是 使 用 谷歌 提供 的 API 查询 、 创 建 和 修改 融合 表 。 
表 B.38 融合 表 控 制 器 模块 的 模块 说 明 


模块 名 称 模 块 模块 说 明 
FusiontablesControl( 实 例 ) 融合 表 控 制 器 实例 
on |. 
返回 查询 结果 事件 ,查询 的 结果 
GotResult( 事 件 ) (result) 以 CSV 格式 返回 
DoQuery( 方 法 ) 该 方法 已 经 被 弃 用 ,被 SentQuery 
取代 
: 丢弃 用 户 的 账户 名 , 当 访 问 融合 表 
ForgetLogin( 方 法 ) 时 强制 进行 重新 认证 
SendQuery( 方 法 ) 执行 查询 融合 表 的 操作 
属性 
读 写 属性 : ApiKey( 谷 歌 API 的 KEY) .Query( 发 送 给 谷歌 融合 表 API 
的 请 求 ) 
2. 微型 数据 库 


微型 数据 库 是 提供 基于 标签 (关键 字 ) 进 行 数据 存储 和 读 取 的 数据 库 。 
表 B.39 微型 数据 库 控件 的 模块 说 明 


模块 名称 BOE LES BH 
TinyDB S: fil» 微型 数据 库 实例 
ClearAll( 方 法 ) 清空 所 有 数据 


ClearTag( 方 法 ) 删除 指定 关键 字 tag 的 条 目 


GetTags( 方 法 ) 返回 数据 库 中 所 有 关键 字 的 列表 
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# 
模块 名 称 模 块 模块 说 明 
将 数据 存储 到 指定 的 关键 字 中 ,tag 是 关键 
StoreValue( 方 法 ) 字 ;valueToStore 是 要 存储 的 数据 ,可 以 是 
字符 串 或 列表 
检索 指定 标签 tag 下 的 数据 ,如 果 指 定 的 
GetValue( 方 法 ) tag 不 存在 , 则 返回 valueIfTagNotThere 
valueIfTagNotThere 的 值 
3. 微型 网 络 数据 库 


微型 网 络 数据 库 是 存储 在 网 络 中 的 微型 数据 库 ,支持 根据 关键 字 的 数据 存储 和 获取 。 
Xx B.40 微型 网 络 数据 库 控件 的 模块 说 明 


模块 名 称 模 K 模块 说 明 
TinyWebDB( 实 例 ) 微型 网 络 数据 库 实例 
Erin: .GotValue 获取 数据 事件 , tagFromWebDB 是 
GotValue( 事 件 ) 获取 数据 的 标签 ,valueFromWebDB 
是 获取 数据 的 值 
ValueStored( 事 件 ) MEME 数据 存储 事件 
WebServiceError( 事 件 ) 网 络 数据 库 服务 出 错 事件 
从 网 络 数据 库 服务 器 中 获取 给 定 标 
GetValue( 方 法 ) 签 为 tag 的 数据 


向 网 络 数据 库 中 存储 标签 为 tag 的 


StoreValue( 方 法 ) 数据 
[Servicen -W 
n 


读 写 属性 : ServiceURL( 微 型 网 络 数据 库 的 URL 值 ) 


B8 通信 控件 


通信 控件 子 类 共有 4 个 控件 ,包括 程序 启动 器 (ActivityStarter)、 蓝 牙 客户 端 
(BluetoothClient) 、 蓝 牙 服务 端 (BlutoothServer) 和 网 页 操作 (Web), 各 控件 的 事件 .属性 
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和 方法 如 表 B. 41 一 表 B. 44 所 示 。 


1. 程序 启动 器 
程序 启动 器 组 件 是 一 个 不 可 见 控件 ,通过 该 控件 可 以 调用 第 三 方 应 用 程序 。 
表 B. 41 程序 启动 器 控件 的 模块 说 明 
模块 名 称 模 块 模块 说 明 
ActivityStarter( 实 例 ) 程序 启动 器 实例 
when Afterhcxivity 
AfterActivity( 事 件 ) 程序 启动 后 事件 
返回 被 调用 的 第 三 方 应 用 程序 的 名 
"T 称 , 若 未 找到 则 返回 空 字符 串 。 通 
ResolveActivity( 方 法 ) a eA 过 本 方法 可 以 确认 第 三 方 应 用 程序 
是 否 已 安装 在 手机 中 
StartActivity( 方 法 ) 启动 第 三 方 应 用 程序 
V Action Vaction 
ActivityClass ActivityClass 
ActivityPackage ActivityPackage 
DataType DataType 
Datari DataUri 
Extrakey ExtraKev 
ExtraValue ExtraValue 
ResultName Result 
ResultNane 
ResultType 
ResultUri 
属性 
读 写 属性 : Action( 调 用 第 三 方 应 用 程序 的 执行 动作 )、ActivityClass( 调 用 第 
三 方 应 用 程序 的 类 名 称 )、ActivityPackage( 调 用 第 三 方 应 用 程序 的 包 名 
称 ) .DataType( 调 用 第 三 方 应 用 程序 的 数据 类 型 )、DataUri( 调 用 第 三 方 应 
用 程序 的 数据 统一 资源 定位 符 )、ExtraKey( 传 递 给 第 三 方 应 用 程序 的 键 名 
TiO .ExtraValueCf£ 3& tA 58 — 77 i FIER B5 88 (8) , ResultName (结果 的 
名 称 ) 
只 读 属性 : Result( 结 果 的 内 容 )、ResultType( 结 果 数 据 类 型 )、ResultUri( 结 
果 的 资源 定位 符 ) 
2. 蓝牙 客户 端 


蓝牙 客户 端 基于 蓝牙 通信 功能 ,实现 与 蓝牙 服务 端的 连接 。 


表 B.42 蓝牙 客户 端 控件 的 模块 说 明 


模块 名 称 E k 模块 说 明 
BluetoothClient 
(实例 ) 蓝牙 客户 端 实例 
BytesAvailableToReceive 在 不 阻塞 的 情况 下 预计 可 接 
(方法 ) 收 的 字 节 数 
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续 表 
模块 名 称 模块 说 明 

通过 指定 的 地 址 蓝牙 address 
Connect( 方 法 ) 与 另 一 个 蓝牙 设备 建立 连接 ， 

成 功 则 返回 true 
" " 通过 指定 的 address 和 UUID 
ES 与 另 一 个 蓝牙 设备 建立 连接 ， 

成 功 则 返回 true 
Disconnect( 方 法 ) 断 开 已 经 连接 的 蓝牙 设备 
IsDevicePaired 检测 是 否 与 指定 的 设备 完成 
(方法 ) 配对 
ReceiveSigned 从 连接 的 蓝牙 设备 接收 一 个 
1ByteNumber( 方 法 ) 字 节 长 度 的 有 符号 数 
ReceiveSigned 从 连接 的 蓝牙 设备 接收 两 个 
2ByteNumber( 方 法 ) 字 节 长 度 的 有 符号 数 
ReceiveSigned 从 连接 的 蓝牙 设备 接收 四 个 
4ByteNumber( 方 法 ) 字 节 长 度 的 有 符号 数 

从 连接 的 蓝牙 设备 接收 多 个 
ReceiveSignedBytes 字 节 的 有 符号 数 的 值 ,如果 
(方法 ) numberOfBytes 小 于 0, 则 一 

直 读 取 直 到 遇 到 结束 符 

从 连接 的 蓝牙 设备 接收 一 个 
ReceiveText( 方 法 ) TH as: ñambertthytes 


小 于 0, 则 一 直 读 取 直 到 遇 到 
结束 符 


ReceiveUnsigned 


从 连接 的 蓝牙 设备 接收 一 个 


1ByteNumber( 方 法 ) 字 节 长 度 的 无 符号 数 
ReceiveUnsigned 从 连接 的 蓝牙 设备 接收 两 个 
2ByteNumber( 方 法 ) 字 节 长 度 的 无 符号 数 


ReceiveUnsigned 
4ByteNumber( 方 法 ) 


从 连接 的 蓝牙 设备 接收 四 个 
字 节 长 度 的 无 符号 数 


ReceiveUnsignedBytes 


(方法 ) 


从 连接 的 蓝牙 设备 接收 多 个 
字 节 的 无 符号 数 的 值 ,如 果 
numberOfBytes 小 于 0, 则 一 
直 读 取 直 到 遇 到 结束 符 


Sendl ByteNumber 向 连接 的 蓝牙 设备 发 送 一 个 
(方法 ) 字 节 长 度 的 数 
Send2ByteNumber 向 连接 的 蓝牙 设备 发 送 两 个 
(方法 ) 字 节 长 度 的 数 
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# 
模块 名 称 模 块 模块 说 明 
Send4ByteNumber 向 连接 的 蓝牙 设备 发 送 四 个 
(方法 ) 字 节 长 度 的 数 
SendBytes( 方 法 ) 向 连接 的 蓝牙 设备 发 送 列表 
SendText( 方 法 ) 向 连接 的 蓝牙 设备 发 送 字 
符 串 
t ER CE 
CharacterEncoding V AddressesAndNanes 
e Available 
Characterfncoding 
Del imi terByte 
Enabled 
HighByteFirst 
—— 
属性 读 写 属性 : CharacterEncoding (接收 信息 的 字符 编码 方式 )、DelimiterByte 
(使 用 ReceiveText、ReceiveSignedBytes、ReceiveUnsignedBytes 等 方法 时 的 
结束 符 ) 、HighByteFirst( 是 否 采用 高 位 优先 传递 的 传输 方式 )、Secure( 是 
否 采用 简易 安全 配对 机 制 ) 
只 读 属性 : AddressesAndNames (已 配对 蓝牙 设备 的 地 址 和 名 称 )、 
AvailableCAndroid 设备 上 的 蓝牙 可 用 性 )、Enabled (蓝牙 功能 是 否 启用 )、 
IsConnected( 是 否 已 建立 连接 ) 
3. 蓝牙 服务 端 
蓝牙 服务 端 基 于 蓝牙 通信 功能 ,实现 与 蓝牙 客户 端的 连接 。 
X B.43 蓝牙 服务 端 控 件 的 模块 说 明 
模块 名 称 模 块 模块 说 明 
BluetoothServer( 实 例 ) 蓝牙 服务 端 实例 
ConnectionAccepted( 事 件 ) ”EE SODALES 
事件 
AcceptConnection( 方 法 ) 接受 外 部 蓝牙 连接 


AcceptConnectionWithUUID 


接受 指定 uuid 的 蓝牙 连 


(方法 ) 接 请 求 
BytesAvailableToReceive 在 不 阻塞 的 情况 下 可 接 
(方法 ) 收 的 字 节 数 (估计 值 

Disconnect( 方 法 ) 断 开 已 经 连接 的 蓝牙 


设备 
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续 表 
模块 名 称 模块 说 明 
ReceiveSignedl ByteNumber 从 连接 的 蓝牙 设备 接收 一 
(方法 ) 个 字 节 长 度 的 有 符号 数 
ReceiveSigned2ByteNumber 从 连接 的 蓝牙 设备 接收 两 
(方法 ) 个 字 节 长 度 的 有 符号 数 
ReceiveSigned4ByteNumber 从 连接 的 蓝牙 设备 接收 四 
(方法 ) 个 字 节 长 度 的 有 符号 数 
从 连接 的 蓝牙 设备 接收 多 
个 字 节 的 有 符号 数 的 值 ， 


ReceiveSignedBytes( 方 法 ) 


如 果 numberOfBytes 小 于 
0, 则 一 直 读 取 直 到 遇 到 结 
RF 


从 连接 的 蓝牙 设备 接收 一 
个 字符 串 mR 


Récene Text n numberOfBytes 小 于 0, W 
一 直 读 取 直 到 遇 到 结束 符 
ReceiveUnsigned 从 连接 的 蓝牙 设备 接收 一 
1ByteNumber( 方 法 ) 个 字 节 长 度 的 无 符号 数 
ReceiveUnsigned 从 连接 的 蓝牙 设备 接收 两 
2ByteNumber( 方 法 ) 个 字 节 长 度 的 无 符号 数 
ReceiveUnsigned 从 连接 的 蓝牙 设备 接收 四 
4ByteNumber( 方 法 ) 个 字 节 长 度 的 无 符号 数 
从 连接 的 蓝牙 设备 接收 多 
个 字 节 的 无 符号 数 的 值 ， 


ReceiveUnsignedBytes 


(方法 ) 


如 果 numberOfBytes 小 于 
0, 则 一 直 读 取 直 到 遇 到 结 
Li 


向 连接 的 蓝牙 设备 发 送 一 
SendlByteNumber( 方 法 ) 个 字 节 长 度 的 数 
Send2ByteNumber( 方 法 ) adit es 
向 连接 的 蓝牙 设备 发 送 四 
Send4ByteNumber( 方 法 ) 个 字 节 长 度 的 数 
SendBytes( 方 法 ) ie 
列表 
SendText( 方 法 ) ONE kisa 
符 串 
StopAccepting (方法 ) 不 再 接受 外 部 连接 请 求 
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续 表 
模块 名 称 BOX 模块 说 明 
V CharacterEncoding 
DelimiterBi CharacterEncoding 
HighByteFirst DeliniterByte 
Secure Enabled 
HighByteFirst 
IsAccepting 
IsConnected 
Secure 
属性 
读 写 属性 : CharacterEncoding (接收 信息 的 字符 编码 方式 )、DelimiterByte( 使 用 
ReceiveText、 ReceiveSignedBytes、ReceiveUnsignedBytes 等 方法 时 的 结束 符 )、 
HighByteFirst( 是 否 采用 高 位 优先 传递 的 传输 方式 )、Secure( 是 否 采用 简易 安全 配 
对 机 制 ) 
只 读 属 性 : Available( Android 设备 上 的 蓝牙 可 用 性 )、Enabled( 蓝 牙 功 能 是 否 启 用 )、 
JsAccepting( 是 否 接受 蓝牙 客户 端的 连接 请 求 ) IsConnected( 是 否 已 建立 连接 ) 
4. 网 页 操作 
网 页 操作 控件 实现 了 在 后 台 进 行 HTTP 获取 和 提交 等 功能 。 
X B.44 网 页 操作 控件 的 模块 说 明 
模块 名 称 模 H 模块 说 明 
Web( 实 例 ) 浏览 器 实例 
"mano .cotrile SaveResponse 属性 设置 为 
GotFile( 事 件 ) true 时 , Get 方法 的 响应 将 
> 产生 文件 ,并 触发 此 事件 
SaveResponse 属性 设置 为 
GotText( 事 件 ) false 时 , Get 方法 的 相应 的 
内 容 并 触发 此 事件 
BuildRequestData 将 有 两 个 元 素 的 子 列表 的 转 
(方法 ) 换 为 格式 化 的 字符 串 
ClearCookies( 方 法 ) 【GE CETT 清空 Cookies 
根据 属性 Url 的 值 执行 一 个 
Delete( 方 法 ) 【call GE .Dolete | HTTP DELETE 的 请 求 ,并 
得 到 一 个 新 的 应 答 
执行 一 个 HTTP GET 请 求 ， 
并 根据 属性 SaveResponse 获 
取 响 应 。 如 果 SaveResponse 
Get( 方 法 ) CE 为 true, 将 响应 保存 成 文件 ， 


并 引发 GetFile 事件 ; 如 果 
SaveResponse 为 false, 将 引 
A Text 事件 
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续 表 
模块 名 称 # 据 模块 说 明 
HtmlTextDecode Sd 
ere 对 html 文本 值 进行 解码 
s 对 Json 文本 值 进行 解码 


PostFile( 方 法 ) 


根据 属性 值 Url 执行 一 个 
HTTP POST 请 求 , path 参 
数 指定 Post 文件 的 路 径 


PostText( 方 法 ) 


根据 属性 值 Url 执行 一 个 
HTTP POST 请 求 , text 参 
数 指定 Post 的 文本 值 


PostTextWithEncoding 
(方法 ) 


根据 属性 值 Url 执行 一 个 
HTTP POST 请 求 , text 参 
数 指定 Post 的 文本 内 容 , 文 


本 内 容 使 用 encoding 指定 的 

参数 进行 编码 

根据 属性 值 Url 执行 一 个 
PutFile( 方 法 ) HTTP PUT 请 求 ,path 参数 

指定 Post 文件 的 路 径 

根据 属性 值 Url 执行 一 个 
Pe EH) HTTP POST 请 求 , text 参 


数 指定 Post 的 文本 值 , text 
的 内 容 使 用 UTF-8 编码 


PutTextWithEncoding 
(方法 ) 


根据 属性 值 Url 执行 一 个 
HTTP POST 请 求 , text 参 
数 指定 Post 的 文本 值 , text 
的 内 容 使 用 encoding 指定 的 
编码 方式 编码 


UriEncode( 方 法 ) 


编码 字符 串 , 使 它 可 以 在 
URL 中 使 用 


属性 


V AllowCookies V AllosCookies 


RequestHeaders 


RequestHeaders 
ResponseFileName 
SaveResponse 

Url 


ResponseFileName 
SaveResponse 
Url 


读 写 属 性 : AllowCookies( 是 否 保存 响应 信息 的 cookies) ,RequestHeaders( 请 
求 头 信息 )、ResponseFileName (返回 信息 的 存储 文件 的 位 置信 息 )、 
SaveResponse( 是 否 将 返回 的 信息 存储 在 一 个 文件 中 ) J Url (request 请 求 的 
Url 值 ) 
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B9 乐高 机 器 人 控件 


乐高 机 器 人 控件 子 类 共 7 个 控件 ,包括 Nxt 颜色 感应 器 (NxtColorSensor) , Nxt 通信 
fii 4 (NxtDirectCommands) , Nxt 电机 (NxtDrive) , Nxt 光 感 应 器 (NxtLightSensor)、Nxt 
声音 感应 器 (NxtSoundSensor) ,Nxt 触摸 感应 器 (NxtTouchSensor) 和 Nxt 超声 波 感应 器 
(NxtUltrasonicSensor) ,各 控件 的 事件 .属性 和 方法 如 表 B. 45 一 表 B. 51 Bron. 


1. Nxt 颜色 感应 器 
Nxt 颜色 感应 器 控件 用 来 控制 乐高 NXT 机 器 人 上 的 颜色 感应 器 。 


X B.45 Nxt 颜色 感应 器 控件 的 模块 说 明 


模块 名 称 模 k 模块 说 明 
NxtColorSensor 
(实例 ) Nxt 颜色 感应 器 实例 
AboveRange( 事 件 ) 当 光 值 高 于 指定 的 范围 时 触发 该 事件 
BelowRange( 事 件 ) 当 光 值 低 于 指定 的 范围 时 触发 该 事件 
ColorChanged( 事 件 ) 检测 到 颜色 发 生 改 变 时 触发 该 事件 
WithinRange( 事 件 ) w 当 光 值 在 指定 的 范围 内 时 触发 该 事件 
GetColor( 方 法 ) 返回 颜色 感应 器 所 检测 到 的 颜色 
GetLightLevel( 方 法 ) 返回 光 值 强度 ( 介 于 0 一 1023 的 整数 ) 


属性 


V AboveRangeEventEnabled 
BelowRangeEventEnabled 
BottcafRange 
ColorChangedEvontEnablod 
DetectColcr 


BelowkangeEventEnabled 
Bottonüffange. 
ColorChangedEventEnabled 


DetectColor 
GenerateCclor 
TopOfRange. 
WithinRangeBventEnabled 


GenerateColor 
Topüffange 
NithinRange£ventEnabled 


读 写 属性 : AboveRangeEventEnabled C? DetectColor 属性 设置 为 false 且 光 值 
大 于 TopOfRange 时 是 否 触发 AboveRange Sf fF) , BelowRangeEventEnabled 
( 当 DetectColor 属性 设置 为 false 且 光 值 低 于 BottomOfRange 时 是 否 触 发 
BelowRange 事 fF) , BottomOfRange (设置 触发 WithinRange、BelowRange、 
AboveRange 等 事件 的 最 小 值 ) ColorChangedEventEnabled C24 f& W 2) 25i £&, 4 
生变 化 时 , 设 定 是 否 触发 ColorChanged 事件 )、DetectColor( 设 定 颜色 感应 器 
是 检测 颜色 还 是 光 值 , 设 为 true 时 检测 颜色 变化 ,反之 检测 光 值 变化 )、 
GenerateColor( 设 定 颜色 感应 器 是 否 发 光 )、TopOfRange (设置 触发 
WithinRange、 BelowRange、 AboveRange 等 事件 的 最 大 值 )、 
WithinRangeEventEnabled( 当 DetectColor 属性 设置 为 false 且 光 值 介 于 
BottomOfRange 与 TopOfRange 之 间 时 ,是 否 触 发 WithinRange 事件 ) 
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2. Nxt 通信 命令 
Nxt 通信 命令 定义 了 对 NXT 智慧 机 器 人 的 通信 命令 ,通过 该 命令 集 可 以 直接 对 机 
器 人 进行 控制 。 
表 B.46 Nxt 通信 命令 控件 的 模块 说 明 


模块 名 称 E k 模块 说 明 
NxtDirectCommands im =: 
(实例 ) SecbireetCossandsi Nxt 通信 命令 实例 
DeleteFile( 方 法 ) 删除 机 器 人 上 的 文件 
DownloadFile( 方 法 ) 将 文件 下 载 到 机 器 人 上 
GetBatteryLevel( 方 法 ) 获得 机 器 人 的 电池 电量 
GetBrickName( 方 法 ) 获得 NXT 主机 名 称 
GetCurrentProgramName 获得 机 器 人 正在 运行 的 程序 
(方法 ) 名 称 
GetFirmwareVersion 获得 机 器 人 固件 和 通信 协议 
(方法 ) 版 本 号 
GetInputValues( 方 法 ) 从 机 器 人 指定 的 输入 端 读 取 
信息 
GetOutputState( 方 法 ) bt 机 器 人 指定 输出 端的 
KeepAlive( 方 法 ) 使 机 器 人 保持 开机 状态 
以 列表 的 方式 返回 机 器 人 中 
ListFiles( 方 法 ) 符合 条 件 wildcard 的 文件 
LsGetStatus( 方 法 ) SKMS Dk aa F 
状态 
从 机 器 人 指定 输入 端 读 取 串 
LsRead( 方 法 ) 行 通信 的 信息 
LsWrite( 方 法 ) pai SSSR 
MessageRead( 方 法 ) Pe qa SSS 


信息 
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续 表 
模块 名 称 HOA 模块 说 明 

MessageWrite( 方 法 ) Re 

信息 
PlaySoundFile( 方 法 ) a EEE MEORUM 

ý 文件 

š " E 
— LAB) IEEE NR 
D TEN 重 设 指定 输入 端口 的 标准 什 
| oe 重 设 电 机 的 位 置 
SetBrickName( 方 法 ) 设 定 NXT 的 主机 名 称 

设 定 机 器 人 指定 输入 端的 状 

Æ , sensorPortLetter 为 输入 
SetInputMode( 方 法 ) 端 编号 , sensorType 为 感应 

器 类 型 , sensorMode 为 感应 

器 返回 值 的 格式 
SetOutputState( 方 法 ) e SSES Sa 
StartProgram( 方 法 ) 运行 已 下 载 到 机 器 上 的 程序 
StopProgram( 方 法 ) 停止 机 器 人 正在 运行 的 程序 
r 停止 播放 声音 

3. Nxt 电机 


Nxt 电机 模块 用 来 控制 NXT 机 器 人 的 马达 ,进而 控制 机 器 人 的 前 进 、 后 退 、 拐 弯 等 


动作 。 
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表 B.47 Nxt 电 机 控件 的 模块 说 明 


模块 名 称 模 块 模块 说 明 
NxtDrive( 实 例 ) Nxt 电机 实例 
机 器 人 以 指定 的 电力 
MoveBackward( 方 法 ) (power) 后 退 指定 的 距 


离 (distance) 


MoveBackwardIndefinitely 让 机 器 人 以 指定 的 电 

(方法 ) 力 (power) 持 续 后 退 
机 器 人 以 指定 的 电力 

MoveForward( 方 法 ) (power) 前 进 指 定 的 距 


离 (distance) 


MoveForwardIndefinitely( 方 法 ) ed s 
Stop( 方 法 ) 所 有 电机 停止 转动 
人 votado dedere 
转动 
es 让 机 器 人 以 指定 的 电 
TurnCounterClockwiseIndefinitely 力 (power) 持 续 逆 时 针 
(方法 ) 转动 


属性 


t B StopBeforeDiaconnect * ] 


读 写 属性 : StopBeforeDisconnect( 设 定 是 否 在 断 开 连接 之 前 将 电机 


停止 运转 ) 


4. Nxt 光 感 应 器 


Nxt 光 感 应 器 模块 用 来 控制 乐高 NXT 机 器 人 上 的 光 感应 器 。 
表 B.48 Nxt 光 感应 器 控件 的 模块 说 明 


模块 名 称 模 k 模块 说 明 
NxtLightSensor( 实 例 ) Nxt 光 感 应 器 实例 
AboveRange( 事 件 ) 当 光 值 高 于 指定 的 范围 时 触发 的 事件 
BelowRange( 事 件 ) 当 光 值 低 于 指定 的 范围 时 触发 的 事件 


HTB 控件 库 


模块 名 称 


模块 说 明 


WithinRange( 事 件 ) 


当 光 值 在 指定 的 范围 内 时 触发 的 事件 


GetLightLevel( 方 法 ) 


E 光 信 强度 ,强度 信介 了 01023 
之 间 


属性 


5. Nxt 声音 感应 器 


V AboveRangeEventEnabled 
BelovhangeEventEnabled 
BottogOfRange 
GenerateLight 
TopOfRange 
NithinfangeEventEnabled 
读 写 属 性 : AboveRangeEventEnabled Ci # 24 J6 (f X F TopOfRange 时 ， 
是 否 触 发 AboveRange 事件) BelowRangeEventEnabled i T 24 X (ñ [I + 
BottomOfRange 时 ,是 否 触发 BelowRange 事件 ) , BottomOfRange i i fih 
发 WithinRange、BelowRange、AboveRange 等 事件 的 最 小 值 )、 
GenerateLight( 光 感应 器 的 前 端 是 否 会 发 光 )、TopOfRange (设置 触发 
WithinRange、BelowRange、AboveRange 等 事件 的 最 大 值 )、 
WithinRangeEventEnabled (设置 当 光 值 介 于 BottomOfRange 与 
TopOfRange 之 间 时 ,是 否 触发 WithinRange 事件 ) 


V AboveRangeEventEnabled 
BelowRangeEventEnabled 
BottogOfRange 
GenerateLight 


opOfRange 
WithinRangeEventEnabled 


Nxt 声音 感应 器 模块 用 来 控制 乐高 NX T 机 器 人 上 的 声音 感应 器 。 


表 B.49 Nxt 声音 感应 器 控件 的 模块 说 明 


模块 名 称 模块 说 明 

NxtSoundSensor 

(实例 ) Nxt 声音 感应 器 实例 

AboveRange( 事 件 ) 当 音 量 高 于 指定 的 范围 时 触发 的 事件 

BelowRange( 事 件 ) 当 音 量 低 于 指定 的 范围 时 触发 的 事件 

WithinRange( 事 件 ) 当 音 量 介 于 指定 的 范围 内 时 触发 的 
事件 

GetSoundLeveal 返回 音量 强度 ,强度 值 介 于 0 一 1023 

(方法 ) 之 间 
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模块 名 称 


V AboveRangeEventEnabled 
BelowRangeEventEnabled 


WithinRangeEventEnabled 


读 写 属性 : AboveRangeEventEnabled i # 4 # #t #8 TopOfRange 时 ,是 否 
属性 触发 AboveRange 3# fF). BelowRangeEventEnabled (设置 当 音 量 低 于 
BottomOfRange 时 ,是 否 触发 BelowRange 事件 )、 BottomOfRange( 设 置 触发 
WithinRange, BelowRange, AboveRange 等 事件 的 最 小 值 )、TopOfRange( 设 置 
触发 WithinRange、BelowRange、AboveRange 等 事件 的 最 大 值 )、 
WithinRangeEventEnabled( 设 置 当 音量 介 于 BottomOfRange 与 TopOfRange 
之 间 时 ,是 否 触 发 WithinRange 事件 ) 


6. Nxt 触摸 感应 器 


Nxt 触摸 感应 器 模块 用 来 控制 乐高 NXT 机 器 人 上 的 触摸 感应 器 o 
X B.50 ”Nxt 触摸 感应 器 控件 的 模块 说 明 


模块 名 称 WO 模块 说 明 
NxtTouchSensor 
e Nu MB Ac 
Pressed( 事 件 ) 当 和 触摸 感应 器 被 按 下 时 触发 的 事件 
Released( 事 件 ) ee 当 触摸 感应 器 被 放 开 时 触发 的 事件 
IsPressed( 方 法 ) EE 返回 触摸 感应 器 是 否 被 按 下 
- ——sx A - 
ReleasedEventEnabled ReleasedEventEnabled 
属性 读 写 属性 : PressedEventEnabled( 设 置 当 触摸 感应 器 被 按 下 时 是 否 能 够 触发 


Pressed 事件 )、.ReleasedEventEnabled( 设 置 放 开 触 摸 感应 器 时 是 否 能 够 触发 
Released 事件 ) 


7. Nxt 超声 波 感应 器 


Nxt 超声 波 感应 器 模块 的 主要 功能 是 用 来 控制 乐高 NXT 机 器 人 上 的 超声 波 感 
应 器 。 


HTB 控件 库 


表 B.51 Nxt 超 声波 感应 器 控件 的 模块 说 明 
模块 名 称 模块 说 明 
NxtUltrasonicSensor 
(实例 ) Nxt 超声 波 感 应 器 实例 
AboveRange( 事 件 ) 当 距 离 大 于 指定 的 范围 时 触发 的 事件 
BelowRange( 事 件 ) 当 距 离 小 于 指定 的 范围 时 触发 的 事件 
WithinRange( 事 件 ) ztUltrasonicSensorl h 当 距 离 介 于 指定 的 范围 之 间 时 触发 的 
事件 
GerDistance NIA) | Mr (0550. AO 全 
V AboveRangeEventEnabled V AboveRangeEventEnabled 
BelosRangeEventEnabled BelowRangegventEnabled 
ortoaorRanee BorroaofRange 
ToporRange TopofRange 
WithinRangeEventEnabled WithinRangeEventEnahled 
读 写 属性 : AboveRangeEventEnabled( 设 置 当 距离 超过 TopOfRange 时 是 否 触 
属性 发 AboveRange $F 件 )、BelowRangeEventEnabled (设置 当 距 离 小 于 


BottomOfRange 时 是 否 触发 BelowRange 事件 )、BottomOfRange (设置 触发 
WithinRange, BelowRange, AboveRange 等 事件 的 最 小 值 )、TopOfRange( 设 置 
触发 WithinRange、BelowRange、AboveRange 等 事件 的 最 大 值 )、 
WithinRangeEventEnabled( 设 置 当 距离 介 于 BottomOfRange 与 TopOfRange 
之 间 时 是 否 触发 WithinRange 事件 ) 


架设 Al2 本 地 服务 器 


在 AI2 的 开发 过 程 中 ,数据 是 保存 在 MIT 的 A12 服务 器 上 的 ,因此 一 定 要 访问 互联 
网 才能 够 进行 AI2 开发 。 这 使 一 些 上 网 不 便 的 用 户 失 去 了 AI2 开发 的 乐趣 ,为 了 解决 这 
个 问题 ,本 附录 中 将 介绍 架设 AI2 本 地 服务 器 的 方法 和 步骤 ,这 样 可 以 在 没有 互联 网 的 
环境 中 开发 AI2 应 用 程序 。 


C1 下 载 所 需 资 源 


在 架设 AI 2 本 地 服务 器 之 前 ,需要 下 载 并 安装 6 个 软件 包 , 这 些 软件 包 有 Java 开发 包 
(jdk-7u55-windows-i586. exe) , Git-1. 9. 0-preview20140217. exe ,apache-ant-1. 9. 3-bin. 


zip.python-2. 7. 6. msi\appengine-java-sdk-1. 9. 2. zip.appinventor-sources-master. zip, 
1. Java 开发 包 


目前 AI2 需要 的 JDK 版 本 是 1.7 版 ,最 新 的 1. 8 版 并 不 适用 。Java 开发 包 的 下 载 网 
址 是 在 http://www. oracle. com/technetwork/java/javase/downloads/jdk7-downloads- 
1880260. html, 如 图 C. 1 所 示 。 首 先 选择 接受 许可 协议 (Accept License Agreement) , 然 
后 选择 相应 版 本 进行 下 载 , 如 图 C. 1 所 示 。 笔 者 使 用 的 是 64 位 的 Windows 7 系统 ,因此 


Š jdi-Tu55-linux-i588.rpm. 
jdk-7u55-linux-586 tar gz 
Š jdk-7u55-linux-x64 rpm 
Inux-x64 tar gz 
jdk-7u55-macosx-x64 dmg 


* jdk-7u55-solaris-i586 tar gz 


5 jdk-7u55-solaris-sparov9 tar Z 
 jdk-7u55-solaris-sparcv9 tar gz 


图 C.1 Java 开发 包 的 下 载 页 面 


DH C 架设 所 本 地 服务 器 


选择 下 载 jdk-7u55-windows-x64. exe。 
下 载 完 成 后 ,双击 Java 开发 包 开 始 安 装 , 如 图 C.2 所 示 。 


W Jeve SE Development Ki 7 Update 55 ` GE ES) io se Development t? Update SS so [E 


歼 迎 使 用 Java SE Development Kit 7 Update 55 安装 向 导 Java SE Development Kit 7 Update 5 已 成 功 安 半 


8782481 EER Java SE Development Kit 7 Upeate 55 GERE e 


BHCIEURRESEIONNE, avt Sc, 开发 人 员 指南 , 发 行 泣 明 以 及 更 多 可 以 村 助 你 


开始 使 用 JOK 的 内 容 。 
LI 
Java Mission Control 分 析 和 访 疡 工具 套件 现在 作为 JOK 的 一 部 分 提供 ~ 
=s 


图 C.2 安装 Java FRE 


Java 开发 包 安 装 完成 后 ,在 Windows 系统 的 CMD 中 输入 “java -version”, 如 果 显 示 
java 开发 包 的 版 本 信息 , 则 表示 安装 成 功 , 如 图 C. 3 所 示 。 


lll C\Windows\system32\cmd.exe 


C.3 Java 开发 包 版 本 信息 


2. Git for Windows 


Git 是 一 种 开源 的 版 本 控制 工具 ,可 用 来 协调 多 人 程序 开发 ,AI2 在 编译 过 程 中 需要 
使 用 Git。 在 浏览 器 地 址 栏 中 输入 Git 的 网 址 http://git-scm. com, 单 击 右 下 方 的 
“Download for Windows” 按 钮 ,下 载 与 系统 匹配 的 Git 版 本 ,如 图 C. 4 所 示 。 

笔者 下 载 的 版 本 是 Git-1. 9. 0-preview20140217. exe。 在 安装 过 程 中 ,在 模块 选择 页 
面 的 “additional icons” 中 将 桌面 和 快捷 启动 栏 中 添加 上 Git 图 标 ,其 他 页 面 选择 默认 值 即 
可 ,如 图 C.5 所 示 。 

Git 安装 完成 后 ,可 以 在 菜单 或 桌面 上 启动 Bash 版 本 或 GUI 版 本 的 Git, 如 图 C. 6 
所 示 。 

3. Apache Ant 


Apache Ant 是 一 个 将 软件 编译 ,测试 、 部 署 等 步骤 联系 在 一 起 加 以 自动 化 的 一 个 工 
具 , 大 多 用 于 Java 环境 中 的 软件 开发 。 进 入 http://ant. apache. org/bindownload. cgi 页 
面 ,从 “Current Release of Ant” 栏 选择 最 新 版 本 的 zip 版 本 的 Apache Ant 进行 下 载 。 笔 
者 下 载 的 版 本 是 apache-ant-1. 9. 3-bin. zip, 如 图 C. 7 所 示 。 
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@ Git Gui 


版 本 库 (repository) 帮助 


BEDERE 
pamend 
pariis end 


图 C.6 Bash 版 本 或 GUI 版 本 的 Git 


Wim C 架设 让 本 地 服务 器 


Current Release of Ant 


urrently, Apache Ant 1.9.3 is the best available version, see the release notes. 


Ant 1.9.3 was released on 29-December-2013 and may not be available on all mirrors for a few days. 


Tar files in the distribution contain long file names, and may require gnu tar to do the extraction. 


[PGP] [SHA1] [SHAS12] [MD5] 
.gz [PGP] [SHA1] [SHA512] [MD5] 
in.tar.bz2 [PGP] [SHA1] [SHAS12] [MD5] 


C.7 Apache Ant 下 载 页 面 


下 载 完 成 后 ,笔者 将 软件 解压 到 C: Napache-ant-1. 9. 3 ,解压 位 置 读者 可 以 自己 选择 。 
然后 在 “系统 属性 ?对 话 框 中 单 击 * 环 境 变 量 ? 按 钮 ,在 打开 的 对 话 框 中 单 击 “ 系 统 变量 ”一 
“编辑 ”按钮 ,在 "Path” 中 追加 Apache Ant 的 bin 目录 的 位 置 。 笔 者 在 系统 变量 Path 中 
追加 的 内 容 为 “;:C:Napache-ant-1. 9. 3\bin”, 如 图 C. 8 所 示 。 


[same un Jan emelie] ole BRE OO 
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启动 和 地 障 恢复 Windows_JT 


系统 启动、 系统 失败 和 i 周 坏 信 息 i2. 
---—- 


Path 
(s Adobe AGL:C Vapache-ant-1. 9 3\bial 


Ce J[ wm J 


C.8 修改 系统 环境 变量 Path 


为 了 判断 Apache Ant 是 否 成 功 安 装 , 在 Windows 系统 的 CMD 中 输入 “ant”, 如 果 
提示 “Buildfile: build. xml does not exist! Build failed”, 则 表示 已 经 部 署 成 功 , 如 图 C. 9 
所 示 。 


lil CAWindows\system32\cmd.exe 


图 C.9 成 功 安装 Apache Ant 
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4. Python 2. 7 


Python 是 一 种 面向 对 象 的 解释 型 计算 机 程序 设计 语言 ,由 Guido van Rossum + 
1989 年 底 发 明 , 目 前 Python 语言 已 被 广泛 使 用 。 目 前 最 新 的 是 Python 3. x 版 本 ,但 AI2 
中 的 Python 脚本 均 为 Python 2. x 版 本 , 若 使 用 Python 3. x 版 本 编译 会 报错 ,所 以 这 里 
必须 使 用 Python 2. 7. 6。 

Python 的 下 载 地 址 是 https://www. python. org/ downloads, 3€ #£ F #& Python 2. 7. 6 
(Download Python 2.7.6), 如 图 C. 10 所 示 。 


Python 


e? python Y ool 


About — Downloads Documentation Community SuccessStones News Events 


Download the latest version for Windows 


Download Python3.40 | Download Pyth 


C.10 Python 下 载 页 面 


下 载 完 成 后 ,安装 步骤 如 图 C. 11 Bros ,都 选择 默认 值 安 装 即 可 。 


JM) Python 2.7.6 Setup $ Python 27.6 Setup. 
Select whether to install Python 2.7.6 Complete the Python 2.7.6 Installer 
for all users of this computer. 
@ Instal for al users 
© Install just for me (not avaiable on Windows Vista) Specti Windows thanks to: 
Mark Hammond, without whose years of freely 
shared Windows expertie, Python for Windows 
would stil be Python for DCS. 
puthon 
for 
n Gick the Finish button to ext the Instaler. 
windows 
[ =< (feta «Bak [Emi Cancel 


图 C.11 安装 Python 


安装 完成 后 ,将 Python 的 安装 目录 追加 到 系统 变量 Path 中 ,如 图 C. 12 所 示 。 


Wim C 架设 外 本 地 服务 器 


C: Vepache-ant-1. 9. 3Vbin;C: VythonZT] 


图 C.12 向 环境 变量 Path 中 添加 Python 的 安装 目录 


5. Google App Engine SDK for Java 


Google App Engine 是 Google 提供 的 云 服 务 平台 ,目前 支持 Python Java 和 Go if 
言 。AI2 使 用 的 是 Java 语言 的 Google App Engine 框架 ,因此 在 下 载 地 址 https:// 
developers. google. com/appengine/downloads 中 选择 Google App Engine SDK for Java 
版 本 的 appengine-java-sdk-1. 9. 3. zip 进行 下 载 , 如 图 C. 13 所 示 。 


Download the Google App Engine SDK 
By downloading, you agree to be bound by the Terms that govern use of the App Engne SDK 


Please note: The App Engine SDK is under active development, please keep this in mind as you explore its capabiitios. See the SDK Release Notes for tho. 
information on the most recent changes to the App Engine SDK. It you discover any issues, please feel free to notify us via cur Issue Tracker. 


> Google App Engine SDK for PHP 
> Google App Engine SDK for Python 


回 eoogle App Engine SDK for Java 


Packago 


193- 2014-04-14 [EE] 1564 MB 4fE2B9c7be21637303b312ba4431c6222bfa16 


* Instaling on Linux 

* Instaling on Mac OS X 
* installing on Windows 
* For More Information 


+ Google App Engine SDK for Go 


» Pre-Release SDKs 


图 C. 13 Google App Engine 下 载 页 面 


下 载 完成 后 ,将 其 解压 到 适当 位 置 。 笔 者 将 appengine-java-sdk-1. 9. 3. zip 解压 至 
C:\appengine-java-sdk-1. 9. 3. 


6. AD 源 代码 


A12 源 代码 的 下 载 位 置 在 https://github. com/mit-cml/appinventor-sources 页 面 ， 
如 图 C. 14 所 示 , 单 击 页 面 右 下 方 的 “Download ZIP” 按 钮 即 可 下 载 AI2 的 源 代码 。 

下 载 的 文件 为 appinventor-sources-master. zip, 下 载 完 成 后 笔者 将 其 解压 到 C.N 
appinventor-sources-master 文件 夹 中 ° 
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C.14 AD 源 代 码 下 载 页 面 


C2 编译 Al2Bi Web 服务 器 


在 完成 基础 软件 的 下 载 和 安装 后 ,下 面 就 可 以 编译 AI2 的 Web 服务 器 了 。 

首先 ,启动 Bash 版 本 的 Git, 遵循 Linux 的 操作 方式 ,进入 AI 源 代码 的 目录 C:\ 
appinventor-sources-masterVappinventor, 

在 Git 的 Bash 中 进入 目录 的 命令 为 cd, 回 退 一 层 目录 的 命令 为 cd.., 列 目录 命令 为 
ls。 因 此 ,进入 AI 源 代 码 的 目录 的 命令 为 “cd /c/ appinventor-sources-master/ 
appinventor”, 成 功 后 会 在 提示 符 中 显示 刚 切 换 到 的 目录 ,如 图 C. 15 所 示 
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'git help git' 
n 'git help 


c/appi 


图 C.15 进入 AI2 的 源 代码 的 目录 


用 户 可 以 在 源 代码 目录 中 使 用 ls 命令 ,显示 当前 目录 中 的 所 有 子 目录 和 文件 ,然后 
输入 ant 命令 启动 编译 过 程 ,如 图 C. 16 所 示 。 


Wis C 架设 所 本 地 服务 器 


编译 过 程 会 持续 一 段 时 间 , 在 编译 完成 后 会 显示 “BUILD SUCCESSFUL”, 如 图 C. 17 
所 示 。 


E3 MINGW32:/c/appinventor-sources-master/appinventor 


图 C.16 ant 命令 启动 编译 过 程 


而 MINGW32:/c/appinventor-sources-master/appinventor 


BuildServer 
ICheckPlayApp 
App 


BUILD ESSFUL 
Total time seconds 


C.17 编译 AD 成 功 


编译 好 AI2 服务 器 后 ,下 一 步 是 启动 AI2 的 Web 服务 ,方法 是 在 Git 的 Bash 中 输入 
启动 命令 /c/appengine-java-sdk-1. 9. 3/bin/dev_appserver. sh —port = 8888 --address 
0.0.0.0 . /appengine/build/war”, 如 图 C. 18 所 示 。 其 中 ,“/c/appengine-java-sdk-1. 9. 
是 安装 在 C 盘 根 目 录 下 的 AppEngine 目录 ;“--port 二 8888” 设 置 本 地 的 Web 服务 端 
口 为 88 address 一 0. 0.0.0? 设 置 本 地 的 W eb 服务 的 IP 地 址 ,“0. 0. 0.0” 表 示 绑 定 本 
机 所 有 有 效 的 IP 地 址 。 
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Bui 


heckplayApp 


图 C.18 启动 AD 的 Web 服务 命令 


AI2 的 Web 服务 成 功 启 动 的 标志 是 在 Bash 中 显示 “Dev App Server is now 
running”, 如 图 C. 19 所 示 。 


可 视 化 开发 Android 应 用 程序 
一 一 拼 阁 开发 模式 App Inventor 2 Cf 208) 


图 C.19 成 功 启动 AL 的 Web 服务 


AI2 的 Web 服务 启动 后 ,在 浏览 器 的 地 址 栏 中 输入 “localhost:8888”, 访 问 刚 启动 的 
AI Web 服务 , 则 会 显示 AI 的 登录 界面 ,如 图 C. 20 所 示 。 


Not logged in 


Email: ltest@example com | 


E Sign in as Adninistrator 


[Login] [Log Out 


C.20 AL2 的 登录 界面 


测试 账号 test@example. com 已 经 自动 添加 在 Email 文本 框 中 ,用 户 只 要 单 击 “Log 
In 按钮 , 即 可 进入 AI2 开发 环境 ,如 图 C. 21 所 示 。 


MIT App Inventor 2 Proect Comect Bud — Heb — My — Gude  Repotan  test@erampk:com 
Projects 


图 C.21 AI2 开发 环境 


C3 编译 AH] Build 服务 器 


虽然 AI2 的 开发 环境 可 以 使 用 了 ,但 用 户 却 不 能 将 应 用 程序 打包 成 apk, 供 用 户 的 计 
算 机 或 手机 下 载 , 就 是 说 图 C. 22 中 的 两 项 功能 是 无 效 的 。 

要 实现 编译 apk 的 功能 ,需要 再 编译 一 个 Build 服务 。 编 译 Build 服务 时 ,需要 重新 
开启 一 个 Git 的 Bash。 需 要 注意 的 是 ,不 要 关闭 启动 Web 服务 的 那个 Bash, 因 为 AI2 的 
Web 服务 由 这 个 Bash 提供 。 


Wis C 架设 让 本 地 服务 器 


Project» — Connect- Buid Help + 


| App ( provide QR code for .apk ) 


App (save .apk to my computer ) 


图 C.22 编译 apk 的 功能 


在 Bash 中 进入 Ci Vappinventor-sources-master Vappinventor 目录 ,然后 输入 “ant 


RunLocalBuildServer” 命 令 , 如 图 C. 23 所 示 。 


8 MINGW32:/c/appinventor-sources-master/appinventor 


$ ant RunLocalBui ldServer 


C.23 编译 和 启动 Build 服务 命令 


编译 结束 后 会 自动 运行 Build 服务 ,如 出 现 “Server running”, 则 表示 Build 服务 运行 


图 C.24 Build 服务 命令 启动 成 功 


